@deneb-ui/cli 2.0.112 → 2.0.113

package/bin/index.js

@@ -1276,6 +1276,18 @@ async function initProject(targetInput, options = {}) {
     // Non-blocking doctor check
   }
 
+  // 7.5. Auto-Fix Editability (ensures all cards, text, and photos have field paths + site-data + recipe)
+  try {
+    const { runAutoEditabilityFix } = require('../src/arc/auto-editability-fixer.cjs');
+    console.log('\n\x1b[36m⚡ Running DENEB auto-editability audit & field sync...\x1b[0m');
+    const fixReport = runAutoEditabilityFix(targetDir, { dryRun: false, verbose: false });
+    if (fixReport.fixed && fixReport.fixed.length > 0) {
+      console.log(`\x1b[32m✔ Auto-fixed ${fixReport.fixed.length} editability targets (field paths, site-data, recipe)\x1b[0m`);
+    }
+  } catch (fixErr) {
+    // Non-blocking auto-fix
+  }
+
   console.log(`\n\x1b[32m✔ Project 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`);
@@ -1666,6 +1678,34 @@ if (command === 'init' || command === 'arc') {
     console.error(`\x1b[31m✖ Failed to save recipe:\x1b[0m ${err.message}`);
     process.exit(1);
   }
+} else if (command === 'fix-editability' || command === 'fix-fields') {
+  let targetInput = '.';
+  let dryRun = false;
+  let verbose = false;
+  for (let i = 0; i < commandArgs.length; i++) {
+    const arg = commandArgs[i];
+    if (arg === '--dry-run' || arg === '--dryrun') {
+      dryRun = true;
+    } else if (arg === '--verbose' || arg === '-v') {
+      verbose = true;
+    } else if (!arg.startsWith('-')) {
+      targetInput = arg;
+    }
+  }
+  const targetDir = path.resolve(process.cwd(), targetInput || '.');
+  try {
+    const { runFixEditability } = require('../src/arc/index.cjs');
+    console.log(`\n\x1b[36m⚡ Running Deneb Auto-Editability Fixer on:\x1b[0m ${targetDir}`);
+    const report = runFixEditability(targetDir, { dryRun, verbose });
+    if (report.fixed.length > 0) {
+      console.log(`\n\x1b[32m✔ Auto-fix completed! Updated ${report.fixed.length} target(s).\x1b[0m\n`);
+    } else {
+      console.log(`\n\x1b[32m✔ All cards, text, and photos are already fully editable!\x1b[0m\n`);
+    }
+  } catch (err) {
+    console.error(`\x1b[31m✖ Auto-fix failed:\x1b[0m ${err.message}`);
+    process.exit(1);
+  }
 } else {
   console.log(`Usage: deneb <command> [options]
   DENEB UI Framework — Powered by DENEB-UI Collaborate with FIVORA
@@ -1682,6 +1722,8 @@ Core Commands:
   fonts             Google Fonts catalog — list presets or install self-hosted @fontsource packages
   update            Update DENEB packages (@deneb-ui/ui, @deneb-ui/cli) and UI components
   validate          Validate website configuration and visual editing contracts with Fivora platform
+  fix-editability   Auto-fix missing field paths: patches components, populates site-data.json, updates recipe
+                    flags: --dry-run  --verbose
   zip               Zip the project without unnecessary folders or files (node_modules, .next, .git, .env)
   validate-and-zip  Validate website configuration and immediately package clean upload-ready ZIP
 
@@ -1714,6 +1756,9 @@ Examples:
   deneb validate-and-zip
   deneb zip .
   deneb add product-card
-  deneb add all`);
+  deneb add all
+  deneb fix-editability .
+  deneb fix-editability . --dry-run
+  deneb fix-editability . --verbose`);
   process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deneb-ui/cli",
-  "version": "2.0.112",
+  "version": "2.0.113",
   "description": "Official DENEB CLI — scaffold, convert, validate, and package Fivora-ready storefront templates.",
   "bin": {
     "deneb": "bin/index.js",
@@ -49,7 +49,7 @@
   "license": "MIT",
   "dependencies": {
     "@babel/parser": "^7.28.0",
-    "@deneb-ui/core": "^2.0.112",
+    "@deneb-ui/core": "^2.0.113",
     "@octokit/rest": "^22.0.1",
     "adm-zip": "^0.6.0",
     "dotenv": "^17.4.2",

package/src/arc/__tests__/arc.test.cjs

@@ -225,6 +225,84 @@ test('AST transformer preserves className and uses nullish fallbacks', () => {
   parseSource(result.code, relativeFile);
 });
 
+test('init marks a variable photo source as an editable image field', () => {
+  const relativeFile = 'src/components/DynamicHero.tsx';
+  const code = `
+export function DynamicHero() {
+  const hero = { src: "/hero.webp" };
+  return <Image src={hero.src} alt="Lounge chair" className="rounded" />;
+}
+`;
+  const profile = scanProject(FIXTURE);
+  const analysis = analyzeFile({
+    code,
+    relativeFile,
+    profile,
+    graph: { sharedFiles: [] },
+    ownerScope: 'home',
+    componentMeta: { name: 'DynamicHero', role: 'hero' },
+  });
+  analysis.relativeFile = relativeFile;
+  analysis.code = code;
+  const image = analysis.candidates.find((candidate) => candidate.reason === 'dynamic-image-source');
+  assert.ok(image, 'expected a dynamic image candidate');
+  const plan = planTransformations({ profile, analyses: [analysis] });
+  const result = applyFilePlan(plan.files[0], profile);
+  assert.match(result.code, /data-preview-field-path="home\.hero\.heroImage"/);
+  assert.match(result.code, /hero\.src/);
+  assert.match(result.code, /\|\|/);
+  parseSource(result.code, relativeFile);
+});
+
+test('init does not assign one shared photo field inside a reusable image component', () => {
+  const relativeFile = 'src/components/VehicleImage.tsx';
+  const code = `
+export function VehicleImage({ image }) {
+  const src = image?.src || "/placeholder.svg";
+  return <Image src={src} alt="" />;
+}
+`;
+  const profile = scanProject(FIXTURE);
+  const analysis = analyzeFile({
+    code,
+    relativeFile,
+    profile,
+    graph: { sharedFiles: [] },
+    ownerScope: 'common',
+    componentMeta: { name: 'VehicleImage', role: 'card' },
+  });
+  const image = analysis.candidates.find((candidate) => candidate.reason === 'dynamic-image-source');
+  assert.equal(image, undefined);
+});
+
+test('init marks a home page photo passed in as a prop', () => {
+  const relativeFile = 'src/components/Hero.tsx';
+  const code = `
+export function Hero({ image }) {
+  return <Image src={image.src} alt="Showroom" />;
+}
+`;
+  const profile = scanProject(FIXTURE);
+  const analysis = analyzeFile({
+    code,
+    relativeFile,
+    profile,
+    graph: { sharedFiles: [] },
+    ownerScope: 'home',
+    componentMeta: { name: 'Hero', role: 'hero' },
+  });
+  analysis.relativeFile = relativeFile;
+  analysis.code = code;
+  const image = analysis.candidates.find((candidate) => candidate.reason === 'dynamic-image-source');
+  assert.ok(image, 'expected a home photo candidate');
+  const plan = planTransformations({ profile, analyses: [analysis] });
+  const result = applyFilePlan(plan.files[0], profile);
+  assert.match(result.code, /data-preview-field-path="home\.hero\.image"/);
+  assert.match(result.code, /image\.src/);
+  assert.match(result.code, /\|\|/);
+  parseSource(result.code, relativeFile);
+});
+
 test('planner emits style-bind next to content transforms', () => {
   const relativeFile = 'src/components/Hero.tsx';
   const code = fs.readFileSync(path.join(FIXTURE, relativeFile), 'utf8');
@@ -3953,9 +4031,38 @@ test('ARC v3 Phase 18: formatBlockedExplanationTerminal renders actionable remed
   }
 });
 
-
-
-
-
-
+test('ARC Component Registry recognizes EditableUniversalCard and multi-industry card aliases', () => {
+  const { isKnownComponent, classifyComponents } = require('../component-registry.cjs');
+  assert.equal(isKnownComponent('EditableUniversalCard'), true);
+  assert.equal(isKnownComponent('UniversalCard'), true);
+  assert.equal(isKnownComponent('ListingCard'), true);
+  assert.equal(isKnownComponent('EntityCard'), true);
+  assert.equal(isKnownComponent('EditableVehicleCard'), true);
+  assert.equal(isKnownComponent('VehicleCard'), true);
+
+  const res = classifyComponents(['UniversalCard', 'VehicleCard', 'UnknownCustomWidget']);
+  assert.deepEqual(res.known, ['UniversalCard', 'VehicleCard']);
+  assert.deepEqual(res.unknown, ['UnknownCustomWidget']);
+});
+
+test('ARC auto-editability fixer handles multi-industry card collections (books, gym plans, restaurants, vehicles)', () => {
+  const { buildGenericCardRecipeSection } = require('../auto-editability-fixer.cjs');
+  const bookCollection = {
+    'book-1': {
+      title: 'To Kill a Mockingbird',
+      author: 'Harper Lee',
+      year: '1960',
+      price: '$18.50',
+    },
+  };
+  const section = buildGenericCardRecipeSection('books', bookCollection);
+  assert.equal(section.id, 'cards.books');
+  assert.equal(section.type, 'collection');
+  assert.equal(section.items.length, 1);
+  assert.equal(section.items[0].key, 'book-1');
+  const keys = section.items[0].fields.map((f) => f.key);
+  assert.ok(keys.includes('title'));
+  assert.ok(keys.includes('author'));
+  assert.ok(keys.includes('price'));
+});
 

package/src/arc/adapters.cjs

@@ -31,6 +31,20 @@ const FORM_CONTAINER_TAGS = new Set(['form', 'Form']);
 
 const ADAPTERS = BUILTIN_ADAPTERS;
 
+const UTILITY_ICON_PATTERNS = [
+  /^(Chevron|Arrow|Move|Caret|Angle|Sort|Chevrons)/i,
+  /^(X|Close|Menu|MenuAlt|Hamburger)/i,
+  /^(Loader|Spinner)/i,
+];
+
+function isUtilityIcon(name) {
+  if (!name) return false;
+  const clean = String(name).replace(/Icon$/i, '');
+  if (UTILITY_ICON_PATTERNS.some((re) => re.test(clean))) return true;
+  const lower = clean.toLowerCase();
+  return ['x', 'close', 'menu', 'spinner', 'loader'].includes(lower);
+}
+
 function isIconComponent(name, importSource) {
   if (!name) return false;
   if (DECORATIVE_TAGS.has(name)) return true;
@@ -39,6 +53,22 @@ function isIconComponent(name, importSource) {
   return false;
 }
 
+function isFeatureIcon(name, importSource) {
+  if (!name) return false;
+  if (DECORATIVE_TAGS.has(name)) return false;
+  if (!isIconComponent(name, importSource)) return false;
+  return !isUtilityIcon(name);
+}
+
+function extractIconBaseName(name) {
+  if (!name) return 'circle';
+  let clean = String(name).replace(/Icon$/i, '');
+  return clean
+    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+    .toLowerCase()
+    .trim();
+}
+
 function classifyHref(href) {
   const value = String(href || '');
   if (/wa\.me|whatsapp/i.test(value)) return 'whatsapp';
@@ -157,6 +187,9 @@ module.exports = {
   recognizeWithAdapters,
   resolveActionWithAdapters,
   isIconComponent,
+  isUtilityIcon,
+  isFeatureIcon,
+  extractIconBaseName,
   classifyHref,
   classifyActionIntent,
   isLikelyCtaClass,