@deneb-ui/cli 2.0.84 → 2.0.86

package/src/arc/adapters/accordion.cjs

@@ -0,0 +1,32 @@
+'use strict';
+
+const { getJsxName } = require('../ast.cjs');
+
+/**
+ * Radix & shadcn Accordion Adapter
+ * Supports Accordion, AccordionItem, AccordionTrigger, AccordionContent.
+ */
+const accordionAdapter = {
+  id: 'accordion',
+
+  detect: () => true,
+
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (name === 'Accordion' || name.endsWith('Accordion')) {
+      return { library: 'accordion', kind: 'collection', role: 'accordion-container', tag: name };
+    }
+    if (name === 'AccordionItem') {
+      return { library: 'accordion', kind: 'collection-item', role: 'accordion-item', tag: name };
+    }
+    if (name === 'AccordionTrigger') {
+      return { library: 'accordion', kind: 'text', role: 'accordion-header', tag: name };
+    }
+    if (name === 'AccordionContent') {
+      return { library: 'accordion', kind: 'text', role: 'accordion-body', tag: name };
+    }
+    return null;
+  },
+};
+
+module.exports = accordionAdapter;

package/src/arc/adapters/dialog.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+const { getJsxName } = require('../ast.cjs');
+
+/**
+ * Radix & shadcn Dialog & Modal Adapter
+ * Supports DialogTitle, DialogDescription, AlertDialogTitle, AlertDialogDescription.
+ */
+const dialogAdapter = {
+  id: 'dialog',
+
+  detect: () => true,
+
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (name === 'DialogTitle' || name === 'AlertDialogTitle') {
+      return { library: 'dialog', kind: 'text', role: 'dialog-title', tag: name };
+    }
+    if (name === 'DialogDescription' || name === 'AlertDialogDescription') {
+      return { library: 'dialog', kind: 'text', role: 'dialog-desc', tag: name };
+    }
+    return null;
+  },
+};
+
+module.exports = dialogAdapter;

package/src/arc/adapters/embla.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+const { getJsxName } = require('../ast.cjs');
+
+/**
+ * Embla & shadcn Carousel Adapter
+ * Supports Carousel, CarouselContent, CarouselItem from embla-carousel or shadcn.
+ */
+const emblaAdapter = {
+  id: 'embla',
+
+  detect: (project) =>
+    (project?.dependencies &&
+      ('embla-carousel' in project.dependencies || 'embla-carousel-react' in project.dependencies)) ||
+    true,
+
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (name === 'Carousel' || name === 'CarouselContent') {
+      return { library: 'embla', kind: 'collection', role: 'carousel-container', tag: name };
+    }
+    if (name === 'CarouselItem') {
+      return { library: 'embla', kind: 'collection-item', role: 'carousel-slide', tag: name };
+    }
+    return null;
+  },
+};
+
+module.exports = emblaAdapter;

package/src/arc/adapters/gallery.cjs

@@ -0,0 +1,23 @@
+'use strict';
+
+const { getJsxName } = require('../ast.cjs');
+
+/**
+ * Gallery & Masonry Grid Adapter
+ * Supports Masonry, Gallery, Lightbox, PhotoGrid components.
+ */
+const galleryAdapter = {
+  id: 'gallery',
+
+  detect: () => true,
+
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (/Masonry|Gallery|Lightbox|PhotoGrid/i.test(name)) {
+      return { library: 'gallery', kind: 'collection', role: 'gallery-container', tag: name };
+    }
+    return null;
+  },
+};
+
+module.exports = galleryAdapter;

package/src/arc/adapters/picture-source.cjs

@@ -0,0 +1,71 @@
+'use strict';
+
+const { getJsxName, getJsxAttributeLiteral, findJsxAttribute, hasJsxAttribute } = require('../ast.cjs');
+
+/**
+ * Responsive Media Adapter (<picture> & <source>)
+ * Supports HTML5 responsive image art direction with multi-breakpoint media queries.
+ */
+const pictureSourceAdapter = {
+  id: 'picture-source',
+
+  detect: () => true,
+
+  recognizeNode(node, ctx) {
+    const name = getJsxName(node);
+    if (name === 'picture') {
+      return {
+        library: 'html',
+        kind: 'responsive-image-container',
+        role: 'picture',
+        tag: 'picture',
+      };
+    }
+    if (name === 'source') {
+      const srcSet = getJsxAttributeLiteral(node, 'srcSet') || getJsxAttributeLiteral(node, 'srcset');
+      const media = getJsxAttributeLiteral(node, 'media');
+      return {
+        library: 'html',
+        kind: 'responsive-image-source',
+        role: 'picture-source',
+        tag: 'source',
+        media: media || undefined,
+        srcSet: srcSet || undefined,
+      };
+    }
+    return null;
+  },
+
+  /**
+   * Extracts responsive configuration from a <picture> JSX node.
+   */
+  extractPictureDetails(pictureNode) {
+    const children = pictureNode.children || [];
+    const sources = [];
+    let fallbackImg = null;
+
+    for (const child of children) {
+      if (!child || child.type !== 'JSXElement') continue;
+      const childName = getJsxName(child);
+      if (childName === 'source') {
+        const srcSet = getJsxAttributeLiteral(child, 'srcSet') || getJsxAttributeLiteral(child, 'srcset');
+        const media = getJsxAttributeLiteral(child, 'media');
+        sources.push({
+          node: child,
+          media,
+          srcSet,
+        });
+      } else if (childName === 'img' || childName === 'Image') {
+        fallbackImg = child;
+      }
+    }
+
+    return {
+      sources,
+      fallbackImg,
+      hasResponsiveSources: sources.length > 0,
+    };
+  },
+};
+
+module.exports = pictureSourceAdapter;

package/src/arc/adapters/registry.cjs

@@ -0,0 +1,156 @@
+'use strict';
+
+const pictureSourceAdapter = require('./picture-source.cjs');
+const swiperAdapter = require('./swiper.cjs');
+const emblaAdapter = require('./embla.cjs');
+const slickAdapter = require('./slick.cjs');
+const accordionAdapter = require('./accordion.cjs');
+const tabsAdapter = require('./tabs.cjs');
+const dialogAdapter = require('./dialog.cjs');
+const galleryAdapter = require('./gallery.cjs');
+const {
+  nextjsAdapter,
+  denebAdapter,
+  shadcnAdapter,
+  herouiAdapter,
+  framerMotionAdapter,
+  reactBitsAdapter,
+  radixAdapter,
+} = require('./ui-frameworks.cjs');
+
+/**
+ * Adapter Registry for Deneb ARC v2
+ * Manages detection, semantic recognition, and transformation across ecosystem libraries.
+ */
+class AdapterRegistry {
+  constructor() {
+    this._adapters = new Map();
+  }
+
+  /**
+   * Registers a new or custom adapter.
+   */
+  register(adapter) {
+    if (!adapter || !adapter.id) {
+      throw new Error('Adapter must provide a unique "id" string');
+    }
+    this._adapters.set(adapter.id, adapter);
+  }
+
+  /**
+   * Retrieves an adapter by its ID.
+   */
+  get(id) {
+    return this._adapters.get(id);
+  }
+
+  /**
+   * Returns all registered adapters.
+   */
+  getAll() {
+    return Array.from(this._adapters.values());
+  }
+
+  /**
+   * Returns adapters active for the given project profile.
+   */
+  getActive(profile = {}) {
+    return this.getAll().filter((adapter) => {
+      try {
+        return typeof adapter.detect === 'function' ? adapter.detect(profile) : true;
+      } catch {
+        return false;
+      }
+    });
+  }
+
+  /**
+   * Dispatches node recognition through active adapters.
+   */
+  recognizeNode(node, ctx, adaptersList) {
+    const active = adaptersList || this.getActive(ctx?.profile);
+    for (const adapter of active) {
+      if (!adapter.recognizeNode) continue;
+      const result = adapter.recognizeNode(node, ctx);
+      if (result) {
+        return { ...result, adapterId: adapter.id };
+      }
+    }
+    return null;
+  }
+
+  /**
+   * Dispatches action resolution through active adapters.
+   */
+  resolveAction(node, adaptersList) {
+    const active = adaptersList || this.getAll();
+    for (const adapter of active) {
+      if (!adapter.resolveAction) continue;
+      const result = adapter.resolveAction(node);
+      if (result) return result;
+    }
+    return null;
+  }
+}
+
+// Global default registry
+const defaultRegistry = new AdapterRegistry();
+
+// Register all standard built-in adapters
+const BUILTIN_ADAPTERS = [
+  nextjsAdapter,
+  denebAdapter,
+  shadcnAdapter,
+  herouiAdapter,
+  framerMotionAdapter,
+  reactBitsAdapter,
+  radixAdapter,
+  pictureSourceAdapter,
+  swiperAdapter,
+  emblaAdapter,
+  slickAdapter,
+  accordionAdapter,
+  tabsAdapter,
+  dialogAdapter,
+  galleryAdapter,
+];
+
+for (const adapter of BUILTIN_ADAPTERS) {
+  defaultRegistry.register(adapter);
+}
+
+function registerAdapter(adapter) {
+  defaultRegistry.register(adapter);
+}
+
+function getAdapter(id) {
+  return defaultRegistry.get(id);
+}
+
+function getAllAdapters() {
+  return defaultRegistry.getAll();
+}
+
+function activeAdapters(profile) {
+  return defaultRegistry.getActive(profile);
+}
+
+function recognizeWithAdapters(node, ctx, adapters) {
+  return defaultRegistry.recognizeNode(node, ctx, adapters);
+}
+
+function resolveActionWithAdapters(node, adapters) {
+  return defaultRegistry.resolveAction(node, adapters);
+}
+
+module.exports = {
+  AdapterRegistry,
+  defaultRegistry,
+  BUILTIN_ADAPTERS,
+  registerAdapter,
+  getAdapter,
+  getAllAdapters,
+  activeAdapters,
+  recognizeWithAdapters,
+  resolveActionWithAdapters,
+};

package/src/arc/adapters/slick.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+const { getJsxName } = require('../ast.cjs');
+
+/**
+ * React-Slick Carousel Adapter
+ * Supports Slider from react-slick / slick-carousel.
+ */
+const slickAdapter = {
+  id: 'slick',
+
+  detect: (project) =>
+    (project?.dependencies &&
+      ('react-slick' in project.dependencies || 'slick-carousel' in project.dependencies)) ||
+    true,
+
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (name === 'Slider') {
+      return { library: 'slick', kind: 'collection', role: 'carousel-container', tag: name };
+    }
+    return null;
+  },
+};
+
+module.exports = slickAdapter;

package/src/arc/adapters/swiper.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+const { getJsxName } = require('../ast.cjs');
+
+/**
+ * Swiper Carousel Adapter
+ * Supports Swiper & SwiperSlide from swiper/react.
+ */
+const swiperAdapter = {
+  id: 'swiper',
+
+  detect: (project) =>
+    (project?.dependencies &&
+      ('swiper' in project.dependencies || 'swiper/react' in project.dependencies)) ||
+    true,
+
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (name === 'Swiper') {
+      return { library: 'swiper', kind: 'collection', role: 'carousel-container', tag: name };
+    }
+    if (name === 'SwiperSlide') {
+      return { library: 'swiper', kind: 'collection-item', role: 'carousel-slide', tag: name };
+    }
+    return null;
+  },
+};
+
+module.exports = swiperAdapter;

package/src/arc/adapters/tabs.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+const { getJsxName } = require('../ast.cjs');
+
+/**
+ * Radix & shadcn Tabs Adapter
+ * Supports Tabs, TabsList, TabsTrigger, TabsContent.
+ */
+const tabsAdapter = {
+  id: 'tabs',
+
+  detect: () => true,
+
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (name === 'Tabs') {
+      return { library: 'tabs', kind: 'structure', role: 'tabs-container', tag: name };
+    }
+    if (name === 'TabsTrigger') {
+      return { library: 'tabs', kind: 'action', role: 'tab-button', tag: name };
+    }
+    if (name === 'TabsContent') {
+      return { library: 'tabs', kind: 'structure', role: 'tab-panel', tag: name };
+    }
+    return null;
+  },
+};
+
+module.exports = tabsAdapter;

package/src/arc/adapters/ui-frameworks.cjs

@@ -0,0 +1,140 @@
+'use strict';
+
+const { getJsxName, hasJsxAttribute } = require('../ast.cjs');
+
+function detectFromProfile(profile, id) {
+  return (profile?.componentLibraries || []).includes(id) || profile?.[id] === true;
+}
+
+const ACTION_TAGS = new Set(['a', 'Link', 'NavLink', 'Button', 'button', 'IconButton', 'NavbarBrand']);
+const HEADING_TAGS = new Set(['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'Heading', 'Title', 'CardTitle', 'ModalHeader', 'DialogTitle']);
+const TEXT_TAGS = new Set(['p', 'span', 'li', 'blockquote', 'figcaption', 'label', 'CardDescription', 'Description', 'Subtitle', 'Typography', 'Text', 'Badge', 'badge']);
+
+const shadcnAdapter = {
+  id: 'shadcn',
+  detect: (project) => detectFromProfile(project, 'shadcn') || project?.shadcn,
+  recognizeNode(node, ctx) {
+    const name = getJsxName(node);
+    if (name === 'Button') {
+      return { library: 'shadcn', kind: 'button', asChild: hasJsxAttribute(node, 'asChild') };
+    }
+    if (name === 'CardTitle' || name === 'CardDescription' || name === 'Badge') {
+      return { library: 'shadcn', kind: 'text', tag: name };
+    }
+    return null;
+  },
+  resolveAction(node) {
+    const name = getJsxName(node);
+    if (name === 'Button' && hasJsxAttribute(node, 'asChild')) {
+      const child = (node.children || []).find((c) => c && c.type === 'JSXElement');
+      if (child && ACTION_TAGS.has(getJsxName(child))) return child;
+    }
+    return null;
+  },
+};
+
+const herouiAdapter = {
+  id: 'heroui',
+  detect: (project) => detectFromProfile(project, 'heroui') || project?.heroui,
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (['Button', 'Link', 'Navbar', 'NavbarBrand', 'NavbarItem', 'NavbarContent'].includes(name)) {
+      return { library: 'heroui', kind: name === 'Button' || name === 'Link' ? 'action' : 'structure', tag: name };
+    }
+    return null;
+  },
+  resolveAction(node) {
+    const name = getJsxName(node);
+    if (name === 'Button' && (hasJsxAttribute(node, 'href') || hasJsxAttribute(node, 'as'))) return node;
+    if (name === 'Link') return node;
+    return null;
+  },
+};
+
+const nextjsAdapter = {
+  id: 'nextjs',
+  detect: (project) => project?.framework === 'nextjs',
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (name === 'Link') return { library: 'nextjs', kind: 'action', tag: 'Link' };
+    if (name === 'Image') return { library: 'nextjs', kind: 'image', tag: 'Image' };
+    return null;
+  },
+  resolveAction(node) {
+    return getJsxName(node) === 'Link' ? node : null;
+  },
+};
+
+const framerMotionAdapter = {
+  id: 'framer-motion',
+  detect: (project) => (project?.animationLibraries || []).includes('framer-motion'),
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (name.startsWith('motion.')) {
+      const tag = name.slice('motion.'.length);
+      return { library: 'framer-motion', kind: HEADING_TAGS.has(tag) || TEXT_TAGS.has(tag) ? 'text' : 'structure', tag };
+    }
+    return null;
+  },
+};
+
+const reactBitsAdapter = {
+  id: 'react-bits',
+  detect: (project) => project?.reactBits,
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (/SplitText|BlurText|GradientText|ShinyText|CountUp|RotatingText/.test(name)) {
+      return { library: 'react-bits', kind: 'text', tag: name };
+    }
+    return null;
+  },
+};
+
+const denebAdapter = {
+  id: 'deneb',
+  detect: (project) =>
+    (project?.componentLibraries || []).includes('@deneb-ui/ui') ||
+    project?.['@deneb-ui/ui'] === true ||
+    Boolean(project?.dependencies && project?.dependencies['@deneb-ui/ui']),
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (['EditableContactForm', 'ContactForm'].includes(name)) {
+      return { library: 'deneb', kind: 'form', tag: name };
+    }
+    if (['EditableGoogleFeedback', 'EditableCustomerReviews', 'CustomerReviews', 'GoogleFeedback'].includes(name)) {
+      return { library: 'deneb', kind: 'feedback', tag: name };
+    }
+    if (['EditableTestimonialSection', 'EditableTestimonialCard', 'TestimonialSection', 'Testimonials'].includes(name)) {
+      return { library: 'deneb', kind: 'testimonial', tag: name };
+    }
+    if (name === 'EditableMap' || name === 'Map') {
+      return { library: 'deneb', kind: 'map', tag: name };
+    }
+    if (['EditableImage', 'EditableText', 'EditableCard', 'EditableProductCard', 'Image', 'Text', 'Card'].includes(name)) {
+      return { library: 'deneb', kind: 'editable-primitive', tag: name };
+    }
+    return null;
+  },
+};
+
+const radixAdapter = {
+  id: 'radix',
+  detect: (project) => (project?.componentLibraries || []).includes('radix'),
+  recognizeNode(node) {
+    const name = getJsxName(node);
+    if (name === 'Slot' || name.endsWith('.Root') || name.endsWith('.Trigger')) {
+      return { library: 'radix', kind: 'structure', tag: name };
+    }
+    return null;
+  },
+};
+
+module.exports = {
+  shadcnAdapter,
+  herouiAdapter,
+  nextjsAdapter,
+  framerMotionAdapter,
+  reactBitsAdapter,
+  denebAdapter,
+  radixAdapter,
+};