@deneb-ui/cli 2.0.0

package/bin/index.js

@@ -0,0 +1,784 @@
+#!/usr/bin/env node
+
+const path = require('node:path');
+const fs = require('node:fs');
+const { spawnSync } = require('node:child_process');
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+const toolsDir = path.join(__dirname, '..', 'src', 'tools');
+
+const FORBIDDEN_DIRS = new Set([
+  '.git',
+  '.next',
+  '.turbo',
+  '.cache',
+  '.npm',
+  '.pnpm-store',
+  '__macosx',
+  'node_modules',
+  'out',
+  'dist',
+  'build',
+  'coverage',
+]);
+
+function isForbiddenFile(filename) {
+  const lower = filename.toLowerCase();
+  return (
+    lower.startsWith('.env') ||
+    lower.endsWith('.zip') ||
+    lower.endsWith('.log') ||
+    lower.endsWith('.tsbuildinfo') ||
+    lower === '.ds_store' ||
+    lower === 'thumbs.db'
+  );
+}
+
+function packageCleanZip(sourceDir, outputPath) {
+  let AdmZip;
+  try {
+    AdmZip = require('adm-zip');
+  } catch {
+    try {
+      const { createRequire } = require('node:module');
+      const projectRequire = createRequire(path.resolve(process.cwd(), 'package.json'));
+      AdmZip = projectRequire('adm-zip');
+    } catch {
+      console.error('Error: adm-zip is required to package templates. Run "npm install -D adm-zip" or install @fivora/cli with its dependencies.');
+      process.exit(1);
+    }
+  }
+
+  const zip = new AdmZip();
+  let fileCount = 0;
+
+  function addFolder(dir, base) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        if (!FORBIDDEN_DIRS.has(entry.name.toLowerCase())) {
+          addFolder(path.join(dir, entry.name), path.join(base, entry.name));
+        }
+      } else if (entry.isFile()) {
+        if (!isForbiddenFile(entry.name)) {
+          const fullPath = path.join(dir, entry.name);
+          const zipPath = path.join(base, entry.name).replace(/\\/g, '/');
+          const targetDirInZip = path.dirname(zipPath) === '.' ? '' : path.dirname(zipPath);
+          zip.addLocalFile(fullPath, targetDirInZip);
+          fileCount++;
+        }
+      }
+    }
+  }
+
+  addFolder(sourceDir, '');
+  zip.writeZip(outputPath);
+  console.log(`\n✓ Successfully packaged clean template ZIP: ${outputPath}`);
+  console.log(`  Packaged ${fileCount} clean source files.`);
+  console.log(`  Automatically excluded: node_modules, .next, .git, .env, cache, and build files.`);
+  console.log(`  Ready for upload at Developer Portal > Upload Template!\n`);
+}
+
+function copyCleanFolder(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      if (!FORBIDDEN_DIRS.has(entry.name.toLowerCase())) {
+        copyCleanFolder(srcPath, destPath);
+      }
+    } else if (entry.isFile()) {
+      if (!isForbiddenFile(entry.name)) {
+        fs.copyFileSync(srcPath, destPath);
+      }
+    }
+  }
+}
+
+function createTemplate(targetName) {
+  const projectName = targetName || 'fivora-template';
+  const targetDir = path.resolve(process.cwd(), projectName);
+  const monorepoTemplateDir = path.resolve(__dirname, '..', '..', '..', 'templates', 'nextjs');
+
+  if (fs.existsSync(monorepoTemplateDir)) {
+    if (fs.existsSync(targetDir) && fs.readdirSync(targetDir).length > 0) {
+      console.error(`\nError: Directory "${projectName}" already exists and is not empty.\n`);
+      process.exit(1);
+    }
+
+    console.log(`\n🚀 Initializing new Fivora Template in ${targetDir}...\n`);
+    copyCleanFolder(monorepoTemplateDir, targetDir);
+
+    const pkgPath = path.join(targetDir, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        pkg.name = path.basename(targetDir).toLowerCase().replace(/[^a-z0-9_-]/g, '-');
+        fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));
+      } catch {
+        // ignore
+      }
+    }
+
+    console.log(`✓ Created Fivora template in ${targetDir}`);
+    console.log(`\nNext steps:`);
+    console.log(`  cd ${projectName}`);
+    console.log(`  npm install`);
+    console.log(`  npm run dev       # Start local development with hot-reload`);
+    console.log(`  npm run lab       # Test in Visual Editing Lab`);
+    console.log(`  npm run validate  # Run Fivora preflight checks`);
+    console.log(`  npm run zip       # Create clean upload-ready ZIP\n`);
+  } else {
+    console.log(`\n🚀 Scaffolding new Fivora Template via @fivora/create-template...\n`);
+    const res = spawnSync('npx', ['--yes', '@fivora/create-template', projectName], {
+      stdio: 'inherit',
+      shell: process.platform === 'win32',
+    });
+    process.exit(res.status ?? 0);
+  }
+}
+
+function detectPages(projectDir) {
+  const pages = [
+    { id: 'home', label: 'Home', route: '/', required: true },
+  ];
+
+  const candidateDirs = [
+    path.join(projectDir, 'src', 'app'),
+    path.join(projectDir, 'app'),
+    path.join(projectDir, 'pages'),
+    path.join(projectDir, 'src', 'pages'),
+  ];
+
+  const foundRoutes = new Set(['/']);
+
+  for (const cDir of candidateDirs) {
+    if (fs.existsSync(cDir) && fs.statSync(cDir).isDirectory()) {
+      try {
+        const entries = fs.readdirSync(cDir, { withFileTypes: true });
+        for (const entry of entries) {
+          if (entry.isDirectory()) {
+            const routeName = entry.name;
+            if (routeName.startsWith('(') || routeName.startsWith('_') || routeName === 'api') {
+              continue;
+            }
+            if (!foundRoutes.has('/' + routeName)) {
+              foundRoutes.add('/' + routeName);
+              const label = routeName
+                .replace(/[-_]/g, ' ')
+                .replace(/\b\w/g, (c) => c.toUpperCase());
+              const isContact = routeName.toLowerCase().includes('contact');
+              pages.push({
+                id: routeName.replace(/[^a-z0-9_-]/gi, '_').toLowerCase(),
+                label: label,
+                route: `/${routeName}`,
+                ...(isContact ? { required: true } : {}),
+              });
+            }
+          }
+        }
+      } catch {
+        // ignore scanning errors
+      }
+    }
+  }
+
+  const hasContact = pages.some((p) => p.id === 'contact' || p.route === '/contact');
+  if (!hasContact) {
+    pages.push({ id: 'contact', label: 'Contact', route: '/contact', required: true });
+  }
+
+  return pages;
+}
+
+function getDefaultManifest(projectName, pages) {
+  return {
+    framework: 'nextjs-static-export',
+    version: 2,
+    visualEditing: {
+      contractVersion: 1,
+      mode: 'strict',
+      controlOnlyPaths: [],
+    },
+    siteDataFile: 'src/data/site-data.json',
+    outputDirectory: 'out',
+    installCommand: 'npm install',
+    buildCommand: 'npm run build',
+    basePathEnvVar: 'NEXT_PUBLIC_SITE_BASE_PATH',
+    pages: pages,
+    editorSchema: {
+      version: 1,
+      sections: [
+        {
+          id: 'common',
+          path: 'common',
+          type: 'object',
+          label: 'Shared Website Content',
+          fields: [
+            {
+              key: 'websiteTitle',
+              type: 'text',
+              label: 'Website Title',
+              required: true,
+            },
+            {
+              key: 'shortDescription',
+              type: 'textarea',
+              label: 'Short Description',
+            },
+            {
+              key: 'logoUrl',
+              type: 'image',
+              label: 'Website Logo',
+            },
+            {
+              key: 'headerCtaLabel',
+              type: 'text',
+              label: 'Header Button Label',
+            },
+          ],
+        },
+        {
+          id: 'home',
+          path: 'home',
+          type: 'object',
+          label: 'Home Page Content',
+          fields: [
+            {
+              key: 'heroTitle',
+              type: 'text',
+              label: 'Hero Title',
+              required: true,
+            },
+            {
+              key: 'heroSummary',
+              type: 'textarea',
+              label: 'Hero Summary',
+            },
+            {
+              key: 'primaryCtaLabel',
+              type: 'text',
+              label: 'Primary CTA Label',
+            },
+            {
+              key: 'secondaryCtaLabel',
+              type: 'text',
+              label: 'Secondary CTA Label',
+            },
+          ],
+        },
+      ],
+    },
+  };
+}
+
+function getDefaultSiteData(projectName, pages) {
+  const navLabels = {};
+  for (const page of pages) {
+    navLabels[page.id] = page.label;
+  }
+
+  return {
+    project: {
+      id: `${projectName}-project`,
+      title: projectName,
+      status: 'APPROVED',
+    },
+    merchant: {
+      businessName: projectName,
+      description: 'A modern commerce storefront built for the Fivora.',
+    },
+    template: {
+      id: `${projectName}-template`,
+      name: projectName,
+      engine: 'NEXT_STATIC_EXPORT',
+      structure: {
+        pages: pages.map((p) => p.id),
+        theme: {
+          primaryColor: '#016a7e',
+          secondaryColor: '#0a1931',
+          accentColor: '#00adb5',
+          backgroundColor: '#ffffff',
+          textColor: '#0f172a',
+          headingFont: 'Inter',
+          bodyFont: 'Inter',
+          baseSize: '16px',
+          heroMinHeight: '70vh',
+          sectionPadding: '4rem',
+        },
+      },
+    },
+    requirements: {
+      requiredPages: pages.filter((p) => p.required).map((p) => p.id),
+      requiredFeatures: [],
+    },
+    content: {
+      common: {
+        websiteTitle: projectName,
+        shortDescription: 'A high-converting online storefront built on the Fivora.',
+        logoUrl: '/fivora-logo.png',
+        headerCtaLabel: 'Contact Us',
+        navLabels: navLabels,
+        footerHeading: 'Powered by Fivora',
+        copyright: `${projectName}. All rights reserved.`,
+      },
+      home: {
+        heroTitle: `Welcome to ${projectName}`,
+        heroSummary: 'Discover our premium collection with fast delivery and great support.',
+        primaryCtaLabel: 'Shop Now',
+        secondaryCtaLabel: 'Learn More',
+      },
+    },
+  };
+}
+
+function initProject(targetInput) {
+  const targetDir = path.resolve(process.cwd(), targetInput || '.');
+  const pkgPath = path.join(targetDir, 'package.json');
+
+  console.log(`\n\x1b[36m╔═══════════════════════════════════════════════════════╗\x1b[0m`);
+  console.log(`\x1b[36m║           \x1b[1mFIVORA TEMPLATE INITIALIZER\x1b[0m\x1b[36m                 ║\x1b[0m`);
+  console.log(`\x1b[36m║   \x1b[90mConfigure existing Next.js app for Fivora\x1b[0m\x1b[36m      ║\x1b[0m`);
+  console.log(`\x1b[36m╚═══════════════════════════════════════════════════════╝\x1b[0m\n`);
+
+  if (!fs.existsSync(pkgPath)) {
+    console.error(`\x1b[31mError:\x1b[0m No package.json found in "${targetDir}".`);
+    console.error(`\nPlease run 'fivora init' inside your Next.js project root, or scaffold a new project with:`);
+    console.error(`  \x1b[36mnpx @fivora/create-template <app-name>\x1b[0m\n`);
+    process.exit(1);
+  }
+
+  let pkg;
+  try {
+    pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+  } catch (err) {
+    console.error(`\x1b[31mError:\x1b[0m Failed to parse package.json: ${err.message}\n`);
+    process.exit(1);
+  }
+
+  const projectName = pkg.name || path.basename(targetDir);
+  console.log(`Configuring project: \x1b[1m${projectName}\x1b[0m in ${targetDir}...\n`);
+
+  // Detect Next.js
+  const hasNext = Boolean(
+    (pkg.dependencies && pkg.dependencies.next) ||
+    (pkg.devDependencies && pkg.devDependencies.next)
+  );
+  if (!hasNext) {
+    console.log(`\x1b[33m⚠ Warning:\x1b[0m Next.js was not detected in dependencies. Fivora templates require Next.js with static export.\n`);
+  }
+
+  // 1. Scan / Detect Pages
+  const detectedPages = detectPages(targetDir);
+
+  // 2. Generate fivora-template.json (or keep fivora-template.json if present)
+  const fivoraManifestPath = path.join(targetDir, 'fivora-template.json');
+  const legacyManifestPath = path.join(targetDir, 'fivora-template.json');
+  const manifestPath = fs.existsSync(legacyManifestPath) && !fs.existsSync(fivoraManifestPath)
+    ? legacyManifestPath
+    : fivoraManifestPath;
+
+  if (!fs.existsSync(manifestPath)) {
+    const manifest = getDefaultManifest(projectName, detectedPages);
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+    console.log(`\x1b[32m✔ Created\x1b[0m fivora-template.json (version 2, strict visual editing contract)`);
+  } else {
+    console.log(`\x1b[90m⏩ Kept existing\x1b[0m ${path.basename(manifestPath)}`);
+  }
+
+  // 3. Generate siteDataFile
+  let manifestObj;
+  try {
+    manifestObj = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+  } catch {
+    manifestObj = {};
+  }
+  const relSiteData = manifestObj.siteDataFile || 'src/data/site-data.json';
+  const siteDataPath = path.join(targetDir, relSiteData);
+
+  if (!fs.existsSync(siteDataPath)) {
+    fs.mkdirSync(path.dirname(siteDataPath), { recursive: true });
+    const siteData = getDefaultSiteData(projectName, detectedPages);
+    fs.writeFileSync(siteDataPath, JSON.stringify(siteData, null, 2) + '\n');
+    console.log(`\x1b[32m✔ Created\x1b[0m ${relSiteData} (merchant & editable site data)`);
+  } else {
+    console.log(`\x1b[90m⏩ Kept existing\x1b[0m ${relSiteData}`);
+  }
+
+  // 4. Update package.json scripts
+  pkg.scripts = pkg.scripts || {};
+  const scriptsToAdd = {
+    'lab': 'fivora lab .',
+    'validate': 'fivora validate .',
+    'zip': 'fivora zip .',
+    'package:template': 'fivora package .',
+    'update:fivora': 'fivora update',
+  };
+  let addedCount = 0;
+  for (const [key, val] of Object.entries(scriptsToAdd)) {
+    if (!pkg.scripts[key]) {
+      pkg.scripts[key] = val;
+      addedCount++;
+    }
+  }
+  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+  if (addedCount > 0) {
+    console.log(`\x1b[32m✔ Injected\x1b[0m Fivora scripts into package.json (lab, validate, zip, package:template, update:fivora)`);
+  } else {
+    console.log(`\x1b[90m⏩ Fivora scripts already present\x1b[0m in package.json`);
+  }
+
+  // 5. Check next.config for static export
+  const nextConfigFiles = ['next.config.ts', 'next.config.mjs', 'next.config.js'];
+  let foundConfig = null;
+  let hasExport = false;
+  for (const cfg of nextConfigFiles) {
+    const cfgPath = path.join(targetDir, cfg);
+    if (fs.existsSync(cfgPath)) {
+      foundConfig = cfg;
+      const content = fs.readFileSync(cfgPath, 'utf8');
+      if (/output\s*:\s*['"]export['"]/.test(content)) {
+        hasExport = true;
+      }
+      break;
+    }
+  }
+
+  if (foundConfig && !hasExport) {
+    console.log(`\n\x1b[33mℹ Note for ${foundConfig}:\x1b[0m Remember to configure static export:`);
+    console.log(`  \x1b[90mconst nextConfig = { output: 'export' };\x1b[0m`);
+  }
+
+  // 6. Install Fivora packages if missing
+  const skipInstall = process.argv.includes('--skip-install');
+  const hasEditable = Boolean(
+    (pkg.dependencies && pkg.dependencies['@fivora/editable-components']) ||
+    (pkg.devDependencies && pkg.devDependencies['@fivora/editable-components'])
+  );
+  const hasCli = Boolean(
+    (pkg.devDependencies && pkg.devDependencies['@fivora/cli']) ||
+    (pkg.dependencies && pkg.dependencies['@fivora/cli'])
+  );
+
+  if (!skipInstall && (!hasEditable || !hasCli)) {
+    const toInstall = [];
+    if (!hasEditable) toInstall.push('@fivora/editable-components');
+    if (!hasCli) toInstall.push('@fivora/cli');
+
+    console.log(`\n📦 Installing ${toInstall.join(' and ')}...`);
+    const installRes = spawnSync('npm', ['install', ...toInstall], {
+      cwd: targetDir,
+      stdio: 'inherit',
+      shell: process.platform === 'win32',
+    });
+    if (installRes.status === 0) {
+      console.log(`\x1b[32m✔ Packages installed successfully!\x1b[0m`);
+    } else {
+      console.log(`\x1b[33mNote: npm install exited with code ${installRes.status}. You can run 'npm i ${toInstall.join(' ')}' manually.\x1b[0m`);
+    }
+  }
+
+  console.log(`\n\x1b[32m✔ Template initialization complete!\x1b[0m`);
+  console.log(`\nYou can now run:`);
+  console.log(`  \x1b[36mnpm run lab\x1b[0m       \x1b[90m# Launch Local Visual Editing Lab\x1b[0m`);
+  console.log(`  \x1b[36mnpm run validate\x1b[0m  \x1b[90m# Check compliance with Fivora contract\x1b[0m`);
+  console.log(`  \x1b[36mnpm run zip\x1b[0m       \x1b[90m# Package clean ZIP for 1-click upload\x1b[0m\n`);
+}
+
+
+function updateDependencies(cmdArgs = []) {
+  let targetDir = '.';
+  let isLocal = false;
+  let localPath = '/mnt/GAMES/GitHub/fivora_package';
+
+  for (let i = 0; i < cmdArgs.length; i++) {
+    const arg = cmdArgs[i];
+    if (arg === '--local' || arg === '-l') {
+      isLocal = true;
+      if (cmdArgs[i + 1] && !cmdArgs[i + 1].startsWith('-')) {
+        localPath = cmdArgs[++i];
+      }
+    } else if (arg.startsWith('--local=')) {
+      isLocal = true;
+      localPath = arg.split('=')[1];
+    } else if (!arg.startsWith('-')) {
+      targetDir = arg;
+    }
+  }
+
+  targetDir = path.resolve(targetDir);
+  const pkgPath = path.join(targetDir, 'package.json');
+
+  if (!fs.existsSync(pkgPath)) {
+    console.error('\x1b[31mError:\x1b[0m No package.json found in ' + targetDir);
+    process.exit(1);
+  }
+
+  let pkg;
+  try {
+    pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+  } catch (err) {
+    console.error('\x1b[31mError:\x1b[0m Failed to parse package.json: ' + err.message);
+    process.exit(1);
+  }
+
+  console.log('\n\x1b[36m╔═══════════════════════════════════════════════════════╗\x1b[0m');
+  console.log('\x1b[36m║             \x1b[1mFIVORA PACKAGE UPDATER\x1b[0m\x1b[36m                    ║\x1b[0m');
+  console.log('\x1b[36m╚═══════════════════════════════════════════════════════╝\x1b[0m\n');
+
+  const currentEditable = String(pkg.dependencies?.['@fivora/editable-components'] || pkg.devDependencies?.['@fivora/editable-components'] || '');
+  const currentCli = String(pkg.dependencies?.['@fivora/cli'] || pkg.devDependencies?.['@fivora/cli'] || '');
+  if (!isLocal && (currentEditable.startsWith('file:') || currentCli.startsWith('file:'))) {
+    isLocal = true;
+  }
+
+  if (isLocal) {
+    const editableDir = path.join(localPath, 'packages', 'editable-components');
+    const cliDir = path.join(localPath, 'cli', 'fivora-cli');
+
+    if (fs.existsSync(editableDir) && fs.existsSync(cliDir)) {
+      console.log('🔄 Updating from local Fivora workspace:');
+      console.log('   - ' + editableDir);
+      console.log('   - ' + cliDir + '\n');
+
+      const installRes = spawnSync('npm', ['install', editableDir, cliDir], {
+        cwd: targetDir,
+        stdio: 'inherit',
+        shell: process.platform === 'win32',
+      });
+
+      if (installRes.status === 0) {
+        console.log('\n\x1b[32m✔ Local Fivora packages re-linked & updated successfully!\x1b[0m\n');
+      } else {
+        console.log('\n\x1b[31m✖ Failed to link local packages (exit code: ' + installRes.status + ')\x1b[0m\n');
+      }
+      return;
+    }
+  }
+
+  console.log('📦 Updating @fivora/editable-components and @fivora/cli to latest from npm...');
+  const packagesToInstall = ['@fivora/editable-components@latest', '@fivora/cli@latest'];
+
+  const installRes = spawnSync('npm', ['install', ...packagesToInstall], {
+    cwd: targetDir,
+    stdio: 'inherit',
+    shell: process.platform === 'win32',
+  });
+
+  if (installRes.status === 0) {
+    console.log('\n\x1b[32m✔ Fivora packages updated to latest versions successfully!\x1b[0m\n');
+  } else {
+    console.log('\n\x1b[31m✖ npm install failed with exit code ' + installRes.status + '\x1b[0m\n');
+  }
+}
+
+function addComponent(componentName, targetDirInput) {
+  const targetDir = path.resolve(targetDirInput || '.');
+  const uiDir = path.join(targetDir, 'src', 'components', 'ui');
+  fs.mkdirSync(uiDir, { recursive: true });
+
+  const pkgPath = path.join(targetDir, 'package.json');
+  let importPkg = '@deneb-ui/ui';
+  if (fs.existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+      if (pkg.dependencies?.['@deneb-ui/ui'] || pkg.devDependencies?.['@deneb-ui/ui']) {
+        importPkg = '@deneb-ui/ui';
+      } else if (pkg.dependencies?.['@deneb/ui'] || pkg.devDependencies?.['@deneb/ui']) {
+        importPkg = '@deneb/ui';
+      } else if (pkg.dependencies?.['@fivora/editable-components'] || pkg.devDependencies?.['@fivora/editable-components']) {
+        importPkg = '@fivora/editable-components';
+      }
+    } catch {
+      // ignore
+    }
+  }
+
+  const REGISTRY = {
+    'button': {
+      file: 'Button.tsx',
+      component: 'Button',
+      code: `'use client';\n\nimport { Button, type EditableButtonProps } from '${importPkg}';\n\nexport { Button, type EditableButtonProps };\n`,
+    },
+    'dialog': {
+      file: 'Dialog.tsx',
+      component: 'Dialog',
+      code: `'use client';\n\nimport { Dialog, DialogHeader, DialogTitle, DialogDescription, DialogFooter, type DialogProps } from '${importPkg}';\n\nexport { Dialog, DialogHeader, DialogTitle, DialogDescription, DialogFooter, type DialogProps };\n`,
+    },
+    'card': {
+      file: 'Card.tsx',
+      component: 'Card',
+      code: `'use client';\n\nimport { Card, type EditableCardProps } from '${importPkg}';\n\nexport { Card, type EditableCardProps };\n`,
+    },
+    'product-card': {
+      file: 'ProductCard.tsx',
+      component: 'EditableProductCard',
+      code: `'use client';\n\nimport { EditableProductCard, type EditableProductCardProps } from '${importPkg}';\n\nexport function ProductCard(props: EditableProductCardProps) {\n  return <EditableProductCard {...props} />;\n}\n`,
+    },
+    'pricing-card': {
+      file: 'PricingCard.tsx',
+      component: 'EditablePricingCard',
+      code: `'use client';\n\nimport { EditablePricingCard, type EditablePricingCardProps } from '${importPkg}';\n\nexport function PricingCard(props: EditablePricingCardProps) {\n  return <EditablePricingCard {...props} />;\n}\n`,
+    },
+    'testimonial-card': {
+      file: 'TestimonialCard.tsx',
+      component: 'EditableTestimonialCard',
+      code: `'use client';\n\nimport { EditableTestimonialCard, type EditableTestimonialCardProps } from '${importPkg}';\n\nexport function TestimonialCard(props: EditableTestimonialCardProps) {\n  return <EditableTestimonialCard {...props} />;\n}\n`,
+    },
+    'contact-form': {
+      file: 'ContactForm.tsx',
+      component: 'EditableContactForm',
+      code: `'use client';\n\nimport { EditableContactForm, type EditableContactFormProps } from '${importPkg}';\n\nexport function ContactForm(props: EditableContactFormProps) {\n  return <EditableContactForm {...props} />;\n}\n`,
+    },
+    'faq': {
+      file: 'FAQAccordion.tsx',
+      component: 'EditableFAQAccordion',
+      code: `'use client';\n\nimport { EditableFAQAccordion, EditableFAQItem, type EditableFAQAccordionProps } from '${importPkg}';\n\nexport function FAQAccordion(props: EditableFAQAccordionProps) {\n  return <EditableFAQAccordion {...props} />;\n}\n\nexport { EditableFAQItem };\n`,
+    },
+    'navbar': {
+      file: 'Navbar.tsx',
+      component: 'EditableNavbar',
+      code: `'use client';\n\nimport { EditableNavbar, type EditableNavbarProps } from '${importPkg}';\n\nexport function Navbar(props: EditableNavbarProps) {\n  return <EditableNavbar {...props} />;\n}\n`,
+    },
+    'footer': {
+      file: 'Footer.tsx',
+      component: 'EditableFooter',
+      code: `'use client';\n\nimport { EditableFooter, type EditableFooterProps } from '${importPkg}';\n\nexport function Footer(props: EditableFooterProps) {\n  return <EditableFooter {...props} />;\n}\n`,
+    },
+    'hero': {
+      file: 'Hero.tsx',
+      component: 'EditableHeroCentered',
+      code: `'use client';\n\nimport { EditableHeroCentered, EditableHeroSplit, type EditableHeroCenteredProps, type EditableHeroSplitProps } from '${importPkg}';\n\nexport function HeroCentered(props: EditableHeroCenteredProps) {\n  return <EditableHeroCentered {...props} />;\n}\n\nexport function HeroSplit(props: EditableHeroSplitProps) {\n  return <EditableHeroSplit {...props} />;\n}\n`,
+    },
+    'whatsapp-button': {
+      file: 'WhatsAppButton.tsx',
+      component: 'WhatsAppButton',
+      code: `'use client';\n\nimport { WhatsAppButton, type WhatsAppButtonProps } from '${importPkg}';\n\nexport { WhatsAppButton, type WhatsAppButtonProps };\n`,
+    },
+    'phone-button': {
+      file: 'PhoneButton.tsx',
+      component: 'PhoneButton',
+      code: `'use client';\n\nimport { PhoneButton, type PhoneButtonProps } from '${importPkg}';\n\nexport { PhoneButton, type PhoneButtonProps };\n`,
+    },
+    'email-button': {
+      file: 'EmailButton.tsx',
+      component: 'EmailButton',
+      code: `'use client';\n\nimport { EmailButton, type EmailButtonProps } from '${importPkg}';\n\nexport { EmailButton, type EmailButtonProps };\n`,
+    },
+    'contact-actions': {
+      file: 'ContactActions.tsx',
+      component: 'ContactActions',
+      code: `'use client';\n\nimport { ContactActions, type ContactActionsProps } from '${importPkg}';\n\nexport { ContactActions, type ContactActionsProps };\n`,
+    },
+    'location-card': {
+      file: 'LocationCard.tsx',
+      component: 'LocationCard',
+      code: `'use client';\n\nimport { LocationCard, type LocationCardProps } from '${importPkg}';\n\nexport { LocationCard, type LocationCardProps };\n`,
+    },
+    'location-link': {
+      file: 'LocationLink.tsx',
+      component: 'LocationLink',
+      code: `'use client';\n\nimport { LocationLink, type LocationLinkProps } from '${importPkg}';\n\nexport { LocationLink, type LocationLinkProps };\n`,
+    },
+    'map-embed': {
+      file: 'MapEmbed.tsx',
+      component: 'MapEmbed',
+      code: `'use client';\n\nimport { MapEmbed, type MapEmbedProps } from '${importPkg}';\n\nexport { MapEmbed, type MapEmbedProps };\n`,
+    },
+    'social-links': {
+      file: 'SocialLinks.tsx',
+      component: 'SocialLinks',
+      code: `'use client';\n\nimport { SocialLinks, type SocialLinksProps } from '${importPkg}';\n\nexport { SocialLinks, type SocialLinksProps };\n`,
+    },
+    'social-button': {
+      file: 'SocialButton.tsx',
+      component: 'SocialButton',
+      code: `'use client';\n\nimport { SocialButton, type SocialButtonProps } from '${importPkg}';\n\nexport { SocialButton, type SocialButtonProps };\n`,
+    },
+    'business-hours': {
+      file: 'BusinessHours.tsx',
+      component: 'BusinessHours',
+      code: `'use client';\n\nimport { BusinessHours, type BusinessHoursProps } from '${importPkg}';\n\nexport { BusinessHours, type BusinessHoursProps };\n`,
+    },
+    'deneb-action': {
+      file: 'DenebAction.tsx',
+      component: 'DenebAction',
+      code: `'use client';\n\nimport { DenebAction, type DenebActionProps } from '${importPkg}';\n\nexport { DenebAction, type DenebActionProps };\n`,
+    },
+  };
+
+  if (!componentName || componentName === 'list') {
+    console.log('\n\x1b[36m╔═══════════════════════════════════════════════════════╗\x1b[0m');
+    console.log('\x1b[36m║               \x1b[1mDENEB UI COMPONENT REGISTRY\x1b[0m\x1b[36m             ║\x1b[0m');
+    console.log('\x1b[36m╚═══════════════════════════════════════════════════════╝\x1b[0m\n');
+    console.log('Available components to add (run "deneb add <name>"):');
+    for (const [key, val] of Object.entries(REGISTRY)) {
+      console.log(`  - \x1b[32m${key.padEnd(18)}\x1b[0m -> src/components/ui/${val.file}`);
+    }
+    console.log(`  - \x1b[32m${'all'.padEnd(18)}\x1b[0m -> Install all components into src/components/ui/\n`);
+    return;
+  }
+
+  const keysToAdd = componentName === 'all' ? Object.keys(REGISTRY) : [componentName.toLowerCase()];
+
+  console.log(`\n\x1b[36m📦 Adding DENEB UI components to:\x1b[0m ${uiDir}\n`);
+
+  for (const key of keysToAdd) {
+    const item = REGISTRY[key];
+    if (!item) {
+      console.error(`\x1b[31m✖ Unknown component:\x1b[0m "${key}". Run "deneb add list" to view available components.`);
+      continue;
+    }
+    const filePath = path.join(uiDir, item.file);
+    fs.writeFileSync(filePath, item.code);
+    console.log(`  \x1b[32m✔ Added\x1b[0m src/components/ui/${item.file}`);
+  }
+
+  console.log('\n\x1b[32m✔ Component(s) added successfully!\x1b[0m');
+  console.log('Import them in your pages:\n  \x1b[90mimport { ... } from "@/components/ui/...";\x1b[0m\n');
+}
+
+if (command === 'init') {
+  initProject(args[1]);
+} else if (command === 'create') {
+  createTemplate(args[1]);
+} else if (command === 'add') {
+  addComponent(args[1], args[2]);
+} else if (command === 'lab') {
+  const script = path.join(toolsDir, 'local-template-lab.cjs');
+  const res = spawnSync(process.execPath, [script, ...args.slice(1)], { stdio: 'inherit' });
+  process.exit(res.status ?? 0);
+} else if (command === 'validate') {
+  const script = path.join(toolsDir, 'fivora-template-validator.cjs');
+  const res = spawnSync(process.execPath, [script, 'validate', ...args.slice(1)], { stdio: 'inherit' });
+  process.exit(res.status ?? 0);
+} else if (command === 'pack' || command === 'zip') {
+  const targetDir = path.resolve(args[1] || '.');
+  const outputZip = path.resolve(targetDir, 'fivora-template.zip');
+  packageCleanZip(targetDir, outputZip);
+} else if (command === 'update' || command === 'upgrade') {
+  updateDependencies(args.slice(1));
+} else if (command === 'package') {
+  const script = path.join(toolsDir, 'fivora-template-validator.cjs');
+  const res = spawnSync(process.execPath, [script, 'package', ...args.slice(1)], { stdio: 'inherit' });
+  process.exit(res.status ?? 0);
+} else {
+  console.log(`Usage: deneb <command> [options] (or fivora <command> [options])
+  DENEB UI Framework — Created by Chamika Gayashan (CEE G)
+
+Commands:
+  add       Add a DENEB UI component to src/components/ui/ (e.g. deneb add product-card)
+  init      Configure an existing Next.js project with missing Fivora files & scripts
+  create    Scaffold a new storefront template (e.g. deneb create my-store)
+  lab       Start the local visual editing lab
+  validate  Validate template visual editing contracts and empty states
+  update    Update DENEB & Fivora packages to latest
+  pack      Quick-package a clean, upload-ready ZIP without junk files (node_modules, .next, .git, .env)
+  zip       Alias for pack
+  package   Run full preflight verification and generate upload ZIP`);
+  process.exit(1);
+}