wally-ui 1.6.0 → 1.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wally-ui",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "About Where’s Wally? Right here — bringing you ready-to-use Angular components with Wally-UI. Stop searching, start building.",
   "bin": {
     "wally": "dist/cli.js"

package/playground/showcase/public/sitemap.xml

@@ -44,4 +44,12 @@
         <priority>0.8</priority>
     </url>
 
+    <!-- Carousel Documentation -->
+    <url>
+        <loc>https://wally-ui.com/documentation/components/carousel</loc>
+        <lastmod>2025-09-27</lastmod>
+        <changefreq>monthly</changefreq>
+        <priority>0.8</priority>
+    </url>
+
 </urlset>

package/playground/showcase/src/app/app.routes.server.ts

@@ -21,6 +21,10 @@ export const serverRoutes: ServerRoute[] = [
     path: 'documentation/components/breadcrumb',
     renderMode: RenderMode.Prerender,
   },
+  {
+    path: 'documentation/components/carousel',
+    renderMode: RenderMode.Prerender,
+  },
   {
     path: 'components',
     renderMode: RenderMode.Prerender,

package/playground/showcase/src/app/components/carousel/carousel.html

@@ -0,0 +1,32 @@
+<div class="w-full flex flex-col items-center gap-4">
+    <div class="relative w-96 h-96 overflow-hidden shadow rounded-lg" #carouselContainer>
+        <ng-content></ng-content>
+    </div>
+
+    <div class="flex items-center gap-3">
+        @for (navigationDot of navigationDotsArray; track $index; let dotIndex = $index) {
+            <button
+                class="size-2 rounded-full transition-all duration-500 ease-in-out cursor-pointer"
+                [ngClass]="{
+                    'bg-blue-500 border scale-150': dotIndex === currentVisibleItemIndex(),
+                    'bg-white hover:bg-gray-400 hover:scale-125': dotIndex !== currentVisibleItemIndex()
+                }"
+                (click)="navigateToSpecificItem(dotIndex)"
+                [attr.aria-label]="'Navigate to slide ' + (dotIndex + 1)">
+            </button>
+        }
+    </div>
+
+    <div class="flex gap-4">
+        <button class="px-4 py-2 bg-gray-700 text-white rounded hover:bg-gray-600 transition-colors duration-200"
+                (click)="navigateToPreviousItem()"
+                aria-label="Go to previous slide">
+            Previous
+        </button>
+        <button class="px-4 py-2 bg-gray-700 text-white rounded hover:bg-gray-600 transition-colors duration-200"
+                (click)="navigateToNextItem()"
+                aria-label="Go to next slide">
+            Next
+        </button>
+    </div>
+</div>

package/playground/showcase/src/app/components/carousel/carousel.ts

@@ -0,0 +1,257 @@
+import { Component, input, OnInit, signal, ViewChild, ElementRef, AfterViewInit, Renderer2, OnDestroy, HostListener } from '@angular/core';
+import { CommonModule } from '@angular/common';
+
+@Component({
+  selector: 'wally-carousel',
+  imports: [CommonModule],
+  templateUrl: './carousel.html',
+})
+export class Carousel implements OnInit, AfterViewInit, OnDestroy {
+  @ViewChild('carouselContainer', { static: false }) carouselContainer!: ElementRef;
+
+  totalItemsCount = signal<number>(0);
+  currentVisibleItemIndex = signal<number>(0);
+  carouselItemElements: HTMLElement[] = [];
+
+  // Touch and swipe gesture state
+  private gestureState = {
+    startPositionX: 0,
+    startPositionY: 0,
+    currentPositionX: 0,
+    currentPositionY: 0,
+    isCurrentlyDragging: false,
+    gestureStartTime: 0
+  };
+
+  // Configuration constants for touch and swipe behavior
+  private readonly MINIMUM_SWIPE_DISTANCE = 50; // minimum pixels to register as swipe
+  private readonly MINIMUM_SWIPE_VELOCITY = 0.3; // minimum velocity to register as swipe
+  private readonly MAXIMUM_SWIPE_DURATION = 300; // maximum milliseconds for swipe gesture
+
+  // Event listener cleanup functions
+  private eventListenerCleanupFunctions: (() => void)[] = [];
+
+  get navigationDotsArray() {
+    return Array(this.totalItemsCount()).fill(0);
+  }
+
+  constructor(private renderer: Renderer2) { }
+
+  ngOnInit(): void {
+  }
+
+  ngAfterViewInit(): void {
+    if (this.carouselContainer) {
+      this.initializeCarouselItems();
+      this.setupTouchAndMouseEvents();
+      this.setupAccessibilityAttributes();
+    }
+  }
+
+  ngOnDestroy(): void {
+    // Clean up all event listeners to prevent memory leaks
+    this.eventListenerCleanupFunctions.forEach(cleanupFunction => cleanupFunction());
+  }
+
+  private initializeCarouselItems(): void {
+    // Get all direct children elements of the carousel container
+    this.carouselItemElements = Array.from(this.carouselContainer.nativeElement.children);
+    this.totalItemsCount.set(this.carouselItemElements.length);
+
+    // Apply positioning and styling to each carousel item using Renderer2
+    this.carouselItemElements.forEach((itemElement, itemIndex) => {
+      this.renderer.setStyle(itemElement, 'position', 'absolute');
+      this.renderer.setStyle(itemElement, 'inset', '0');
+      this.renderer.setStyle(itemElement, 'transition', 'transform 700ms ease-out');
+      this.renderer.setStyle(itemElement, 'display', 'flex');
+      this.renderer.setStyle(itemElement, 'align-items', 'center');
+      this.renderer.setStyle(itemElement, 'justify-content', 'center');
+      this.updateItemElementPosition(itemElement, itemIndex);
+    });
+  }
+
+  private setupTouchAndMouseEvents(): void {
+    const carouselContainerElement = this.carouselContainer.nativeElement;
+
+    // Touch events for mobile devices
+    const touchStartListener = this.renderer.listen(carouselContainerElement, 'touchstart', (event) => this.handleTouchStart(event));
+    const touchMoveListener = this.renderer.listen(carouselContainerElement, 'touchmove', (event) => this.handleTouchMove(event));
+    const touchEndListener = this.renderer.listen(carouselContainerElement, 'touchend', () => this.handleTouchEnd());
+
+    // Mouse events for desktop devices
+    const mouseDownListener = this.renderer.listen(carouselContainerElement, 'mousedown', (event) => this.handleMouseDown(event));
+    const mouseMoveListener = this.renderer.listen(carouselContainerElement, 'mousemove', (event) => this.handleMouseMove(event));
+    const mouseUpListener = this.renderer.listen(carouselContainerElement, 'mouseup', () => this.handleMouseUp());
+    const mouseLeaveListener = this.renderer.listen(carouselContainerElement, 'mouseleave', () => this.handleMouseUp());
+
+    // Store all cleanup functions for proper memory management
+    this.eventListenerCleanupFunctions.push(
+      touchStartListener,
+      touchMoveListener,
+      touchEndListener,
+      mouseDownListener,
+      mouseMoveListener,
+      mouseUpListener,
+      mouseLeaveListener
+    );
+
+    // Optimize touch performance by restricting to horizontal panning only
+    this.renderer.setStyle(carouselContainerElement, 'touch-action', 'pan-x');
+  }
+
+  private setupAccessibilityAttributes(): void {
+    const carouselContainerElement = this.carouselContainer.nativeElement;
+
+    // Set ARIA attributes for screen readers and accessibility
+    this.renderer.setAttribute(carouselContainerElement, 'role', 'region');
+    this.renderer.setAttribute(carouselContainerElement, 'aria-label', 'Carousel');
+    this.renderer.setAttribute(carouselContainerElement, 'tabindex', '0');
+  }
+
+  updateItemElementPosition(carouselItemElement: HTMLElement, itemIndex: number): void {
+    const currentVisibleIndex = this.currentVisibleItemIndex();
+
+    if (itemIndex === currentVisibleIndex) {
+      // Position the currently visible item at center (0% translation)
+      this.renderer.setStyle(carouselItemElement, 'transform', 'translateX(0)');
+    } else if (itemIndex > currentVisibleIndex) {
+      // Position items to the right of current item (110% translation to the right)
+      this.renderer.setStyle(carouselItemElement, 'transform', 'translateX(110%)');
+    } else {
+      // Position items to the left of current item (110% translation to the left)
+      this.renderer.setStyle(carouselItemElement, 'transform', 'translateX(-110%)');
+    }
+  }
+
+  updateAllItemElementPositions(): void {
+    this.carouselItemElements.forEach((itemElement, itemIndex) => {
+      this.updateItemElementPosition(itemElement, itemIndex);
+    });
+  }
+
+  // Touch event handlers for mobile devices
+  private handleTouchStart(touchEvent: TouchEvent): void {
+    this.initializeGesture(touchEvent.touches[0].clientX, touchEvent.touches[0].clientY);
+  }
+
+  private handleTouchMove(touchEvent: TouchEvent): void {
+    if (this.gestureState.isCurrentlyDragging) {
+      touchEvent.preventDefault(); // Prevent page scrolling during swipe
+      this.updateGesturePosition(touchEvent.touches[0].clientX, touchEvent.touches[0].clientY);
+    }
+  }
+
+  private handleTouchEnd(): void {
+    this.finalizeGestureAndNavigate();
+  }
+
+  // Mouse event handlers for desktop devices
+  private handleMouseDown(mouseEvent: MouseEvent): void {
+    this.initializeGesture(mouseEvent.clientX, mouseEvent.clientY);
+  }
+
+  private handleMouseMove(mouseEvent: MouseEvent): void {
+    if (this.gestureState.isCurrentlyDragging) {
+      mouseEvent.preventDefault(); // Prevent text selection during drag
+      this.updateGesturePosition(mouseEvent.clientX, mouseEvent.clientY);
+    }
+  }
+
+  private handleMouseUp(): void {
+    this.finalizeGestureAndNavigate();
+  }
+
+  // Unified gesture handling methods
+  private initializeGesture(xPosition: number, yPosition: number): void {
+    this.gestureState = {
+      startPositionX: xPosition,
+      startPositionY: yPosition,
+      currentPositionX: xPosition,
+      currentPositionY: yPosition,
+      isCurrentlyDragging: true,
+      gestureStartTime: Date.now()
+    };
+  }
+
+  private updateGesturePosition(xPosition: number, yPosition: number): void {
+    if (!this.gestureState.isCurrentlyDragging) return;
+
+    this.gestureState.currentPositionX = xPosition;
+    this.gestureState.currentPositionY = yPosition;
+  }
+
+  private finalizeGestureAndNavigate(): void {
+    if (!this.gestureState.isCurrentlyDragging) return;
+
+    const horizontalDistanceMoved = this.gestureState.currentPositionX - this.gestureState.startPositionX;
+    const verticalDistanceMoved = this.gestureState.currentPositionY - this.gestureState.startPositionY;
+    const gestureDuration = Date.now() - this.gestureState.gestureStartTime;
+    const gestureVelocity = Math.abs(horizontalDistanceMoved) / gestureDuration;
+
+    // Only process horizontal swipes (ignore vertical movements)
+    if (Math.abs(horizontalDistanceMoved) > Math.abs(verticalDistanceMoved)) {
+      // Check if gesture meets minimum requirements for navigation
+      const isValidSwipeGesture = Math.abs(horizontalDistanceMoved) > this.MINIMUM_SWIPE_DISTANCE ||
+        (gestureVelocity > this.MINIMUM_SWIPE_VELOCITY && gestureDuration < this.MAXIMUM_SWIPE_DURATION);
+
+      if (isValidSwipeGesture) {
+        if (horizontalDistanceMoved > 0) {
+          this.navigateToPreviousItem(); // Swipe right = go to previous item
+        } else {
+          this.navigateToNextItem(); // Swipe left = go to next item
+        }
+      }
+    }
+
+    // Reset gesture state after processing
+    this.gestureState.isCurrentlyDragging = false;
+  }
+
+  // Keyboard navigation handler
+  @HostListener('keydown', ['$event'])
+  handleKeyboardNavigation(keyboardEvent: KeyboardEvent): void {
+    switch (keyboardEvent.key) {
+      case 'ArrowLeft':
+        keyboardEvent.preventDefault();
+        this.navigateToPreviousItem();
+        break;
+      case 'ArrowRight':
+        keyboardEvent.preventDefault();
+        this.navigateToNextItem();
+        break;
+      case 'Home':
+        keyboardEvent.preventDefault();
+        this.navigateToSpecificItem(0);
+        break;
+      case 'End':
+        keyboardEvent.preventDefault();
+        this.navigateToSpecificItem(this.totalItemsCount() - 1);
+        break;
+    }
+  }
+
+  // Circular buffer algorithm implementation for infinite carousel navigation
+  calculateNextItemIndex(currentItemIndex: number): number {
+    return (currentItemIndex + 1) % this.totalItemsCount();
+  }
+
+  calculatePreviousItemIndex(currentItemIndex: number): number {
+    return (currentItemIndex - 1 + this.totalItemsCount()) % this.totalItemsCount();
+  }
+
+  navigateToNextItem(): void {
+    this.currentVisibleItemIndex.set(this.calculateNextItemIndex(this.currentVisibleItemIndex()));
+    this.updateAllItemElementPositions();
+  }
+
+  navigateToPreviousItem(): void {
+    this.currentVisibleItemIndex.set(this.calculatePreviousItemIndex(this.currentVisibleItemIndex()));
+    this.updateAllItemElementPositions();
+  }
+
+  navigateToSpecificItem(targetItemIndex: number): void {
+    this.currentVisibleItemIndex.set(targetItemIndex);
+    this.updateAllItemElementPositions();
+  }
+  // end test Circular Buffer ---
+}

package/playground/showcase/src/app/pages/documentation/components/carousel-docs/carousel-docs.examples.ts

@@ -0,0 +1,48 @@
+// Carousel documentation code examples
+export const CarouselCodeExamples = {
+  // Installation
+  installation: `npx wally-ui add carousel`,
+
+  // Import examples
+  import: `import { Carousel } from './components/wally-ui/carousel/carousel';`,
+  componentImport: `@Component({
+  selector: 'app-example',
+  imports: [Carousel],
+  templateUrl: './example.html',
+  styleUrl: './example.css'
+})`,
+
+  // Basic usage
+  basicUsage: `<wally-carousel>
+  <div>Item 1</div>
+  <div>Item 2</div>
+</wally-carousel>`,
+
+  // Custom content example
+  customContent: `<wally-carousel>
+  <div class="w-full h-full bg-gradient-to-r from-blue-500 to-purple-600 text-white flex flex-col items-center justify-center p-6">
+    <h3 class="text-xl font-bold mb-2">Feature 1</h3>
+    <p class="text-center text-sm">Custom slide with rich content</p>
+  </div>
+  <div class="w-full h-full bg-gradient-to-r from-green-500 to-blue-500 text-white flex flex-col items-center justify-center p-6">
+    <h3 class="text-xl font-bold mb-2">Feature 2</h3>
+    <p class="text-center text-sm">Another slide with different styling</p>
+  </div>
+</wally-carousel>`,
+
+  // Properties
+  properties: `// Component properties
+// The carousel automatically detects child elements and creates navigation
+// Currently no input properties - content projection only
+
+// Available interactions:
+// • Click navigation buttons (Previous/Next)
+// • Click dot indicators for direct navigation
+// • Touch/swipe gestures on mobile and desktop
+// • Keyboard navigation (Arrow keys, Home, End)
+
+// Auto-detected features:
+totalItemsCount: number;              // Automatically set based on child elements
+currentVisibleItemIndex: number;     // Currently visible slide index (0-based)
+navigationDotsArray: any[];          // Auto-generated dot indicators`
+};

package/playground/showcase/src/app/pages/documentation/components/carousel-docs/carousel-docs.html

@@ -0,0 +1,156 @@
+<div class="font-mono">
+  <div class="max-w-4xl mx-auto p-6">
+    <div class="mb-4">
+      <wally-breadcrumb [items]="breadcrumbItems"></wally-breadcrumb>
+    </div>
+
+    <h1 class="text-2xl font-bold mb-4 text-[#0a0a0a] dark:text-white">
+      Carousel
+    </h1>
+    <p class="text-gray-700 dark:text-gray-400 mb-4">
+      A carousel component with navigation controls, touch gestures, and smooth transitions.
+    </p>
+
+    <!-- Under Construction Badge -->
+    <div class="mb-6">
+      <span class="text-xs bg-yellow-500 text-black px-3 py-1 rounded-full font-medium">Under Construction</span>
+      <p class="text-sm text-gray-600 dark:text-gray-400 mt-2">
+        This component is actively being developed. Touch gestures, accessibility, and customization options are coming soon.
+      </p>
+    </div>
+
+    <!-- AI Prompts -->
+    <div class="flex flex-wrap gap-2 mb-6">
+      <a [href]="claudeUrl" target="_blank"
+        class="inline-flex items-center gap-2 px-3 py-1.5 text-xs bg-gray-200 dark:bg-[#121212] text-gray-600 dark:text-gray-300 rounded-lg hover:bg-gray-300 dark:hover:bg-[#1a1a1a] hover:text-[#0a0a0a] dark:hover:text-white transition-colors">
+        <svg xmlns="http://www.w3.org/2000/svg" class="size-6" viewBox="0 0 24 24">
+          <path fill="currentColor"
+            d="m4.714 15.956l4.718-2.648l.079-.23l-.08-.128h-.23l-.79-.048l-2.695-.073l-2.337-.097l-2.265-.122l-.57-.121l-.535-.704l.055-.353l.48-.321l.685.06l1.518.104l2.277.157l1.651.098l2.447.255h.389l.054-.158l-.133-.097l-.103-.098l-2.356-1.596l-2.55-1.688l-1.336-.972l-.722-.491L2 6.223l-.158-1.008l.656-.722l.88.06l.224.061l.893.686l1.906 1.476l2.49 1.833l.364.304l.146-.104l.018-.072l-.164-.274l-1.354-2.446l-1.445-2.49l-.644-1.032l-.17-.619a3 3 0 0 1-.103-.729L6.287.133L6.7 0l.995.134l.42.364l.619 1.415L9.735 4.14l1.555 3.03l.455.898l.243.832l.09.255h.159V9.01l.127-1.706l.237-2.095l.23-2.695l.08-.76l.376-.91l.747-.492l.583.28l.48.685l-.067.444l-.286 1.851l-.558 2.903l-.365 1.942h.213l.243-.242l.983-1.306l1.652-2.064l.728-.82l.85-.904l.547-.431h1.032l.759 1.129l-.34 1.166l-1.063 1.347l-.88 1.142l-1.263 1.7l-.79 1.36l.074.11l.188-.02l2.853-.606l1.542-.28l1.84-.315l.832.388l.09.395l-.327.807l-1.967.486l-2.307.462l-3.436.813l-.043.03l.049.061l1.548.146l.662.036h1.62l3.018.225l.79.522l.473.638l-.08.485l-1.213.62l-1.64-.389l-3.825-.91l-1.31-.329h-.183v.11l1.093 1.068l2.003 1.81l2.508 2.33l.127.578l-.321.455l-.34-.049l-2.204-1.657l-.85-.747l-1.925-1.62h-.127v.17l.443.649l2.343 3.521l.122 1.08l-.17.353l-.607.213l-.668-.122l-1.372-1.924l-1.415-2.168l-1.141-1.943l-.14.08l-.674 7.254l-.316.37l-.728.28l-.607-.461l-.322-.747l.322-1.476l.388-1.924l.316-1.53l.285-1.9l.17-.632l-.012-.042l-.14.018l-1.432 1.967l-2.18 2.945l-1.724 1.845l-.413.164l-.716-.37l.066-.662l.401-.589l2.386-3.036l1.439-1.882l.929-1.086l-.006-.158h-.055L4.138 18.56l-1.13.146l-.485-.456l.06-.746l.231-.243l1.907-1.312Z" />
+        </svg>
+        Open in Claude
+      </a>
+
+      <a [href]="chatGptUrl" target="_blank"
+        class="inline-flex items-center gap-2 px-3 py-1.5 text-xs bg-gray-200 dark:bg-[#121212] text-gray-600 dark:text-gray-300 rounded-lg hover:bg-gray-300 dark:hover:bg-[#1a1a1a] hover:text-[#0a0a0a] dark:hover:text-white transition-colors">
+        <svg xmlns="http://www.w3.org/2000/svg" class="size-6" viewBox="0 0 48 48">
+          <path fill="none" stroke="currentColor" stroke-width="3" stroke-linejoin="round"
+            d="M18.38 27.94v-14.4l11.19-6.46c6.2-3.58 17.3 5.25 12.64 13.33" />
+          <path fill="none" stroke="currentColor" stroke-width="3" stroke-linejoin="round"
+            d="m18.38 20.94l12.47-7.2l11.19 6.46c6.2 3.58 4.1 17.61-5.23 17.61" />
+          <path fill="none" stroke="currentColor" stroke-width="3" stroke-linejoin="round"
+            d="m24.44 17.44l12.47 7.2v12.93c0 7.16-13.2 12.36-17.86 4.28" />
+          <path fill="none" stroke="currentColor" stroke-width="3" stroke-linejoin="round"
+            d="M30.5 21.2v14.14L19.31 41.8c-6.2 3.58-17.3-5.25-12.64-13.33" />
+          <path fill="none" stroke="currentColor" stroke-width="3" stroke-linejoin="round"
+            d="m30.5 27.94l-12.47 7.2l-11.19-6.46c-6.21-3.59-4.11-17.61 5.22-17.61" />
+          <path fill="none" stroke="currentColor" stroke-width="3" stroke-linejoin="round"
+            d="m24.44 31.44l-12.47-7.2V11.31c0-7.16 13.2-12.36 17.86-4.28" />
+        </svg>
+        Open in ChatGPT
+      </a>
+    </div>
+
+    <!-- Installation -->
+    <section class="mb-8">
+      <h2 class="text-lg font-semibold mb-4 text-[#0a0a0a] dark:text-white">Installation</h2>
+      <div class="bg-gray-200 dark:bg-[#121212] p-4 rounded-lg">
+        <pre><code [innerHTML]="installationCode" class="text-sm text-[#0a0a0a] dark:text-white"></code></pre>
+      </div>
+    </section>
+
+    <!-- Preview -->
+    <section class="mb-8">
+      <h2 class="text-lg font-semibold mb-4 text-[#0a0a0a] dark:text-white">Preview</h2>
+      <div class="p-6 border rounded-lg bg-white dark:bg-[#121212]">
+        <div class="flex justify-center">
+          <wally-carousel>
+            <div class="w-full h-full bg-blue-500 text-white flex items-center justify-center text-lg font-semibold">
+              Slide 1
+            </div>
+            <div class="w-full h-full bg-green-500 text-white flex items-center justify-center text-lg font-semibold">
+              Slide 2
+            </div>
+            <div class="w-full h-full bg-purple-500 text-white flex items-center justify-center text-lg font-semibold">
+              Slide 3
+            </div>
+          </wally-carousel>
+        </div>
+      </div>
+    </section>
+
+    <!-- Import -->
+    <section class="mb-8">
+      <h2 class="text-lg font-semibold mb-4 text-[#0a0a0a] dark:text-white">Import</h2>
+      <div class="space-y-4">
+        <div class="bg-gray-200 dark:bg-[#121212] p-4 rounded-lg">
+          <pre><code [innerHTML]="importCode" class="text-sm text-[#0a0a0a] dark:text-white"></code></pre>
+        </div>
+
+        <div class="bg-gray-200 dark:bg-[#121212] p-4 rounded-lg">
+          <pre><code [innerHTML]="componentImportCode" class="text-sm text-[#0a0a0a] dark:text-white"></code></pre>
+        </div>
+      </div>
+    </section>
+
+    <!-- Basic Usage -->
+    <section class="mb-8">
+      <h2 class="text-lg font-semibold mb-4 text-[#0a0a0a] dark:text-white">Basic Usage</h2>
+      <div class="bg-gray-200 dark:bg-[#121212] p-4 rounded-lg mb-4">
+        <pre><code [innerHTML]="basicUsageCode" class="text-sm text-[#0a0a0a] dark:text-white"></code></pre>
+      </div>
+      <div class="p-6 border rounded-lg bg-white dark:bg-[#121212]">
+        <div class="flex justify-center">
+          <wally-carousel>
+            <div class="w-full h-full bg-blue-400 text-white flex items-center justify-center">
+              Item 1
+            </div>
+            <div class="w-full h-full bg-green-400 text-white flex items-center justify-center">
+              Item 2
+            </div>
+          </wally-carousel>
+        </div>
+      </div>
+    </section>
+
+    <!-- Advanced Examples -->
+    <section class="mb-8">
+      <h2 class="text-lg font-semibold mb-4 text-[#0a0a0a] dark:text-white">Advanced Examples</h2>
+
+      <!-- Custom Content Example -->
+      <div class="mb-6">
+        <h3 class="text-md font-medium mb-3 text-[#0a0a0a] dark:text-white">Custom Content</h3>
+        <div class="bg-gray-200 dark:bg-[#121212] p-4 rounded-lg mb-4">
+          <pre><code [innerHTML]="customContentCode" class="text-sm text-[#0a0a0a] dark:text-white"></code></pre>
+        </div>
+        <div class="p-6 border rounded-lg bg-white dark:bg-[#121212]">
+          <div class="flex justify-center">
+            <wally-carousel>
+              <div class="w-full h-full bg-gradient-to-r from-blue-500 to-purple-600 text-white flex flex-col items-center justify-center p-6">
+                <h3 class="text-xl font-bold mb-2">Feature 1</h3>
+                <p class="text-center text-sm">This is a custom slide with rich content</p>
+              </div>
+              <div class="w-full h-full bg-gradient-to-r from-green-500 to-blue-500 text-white flex flex-col items-center justify-center p-6">
+                <h3 class="text-xl font-bold mb-2">Feature 2</h3>
+                <p class="text-center text-sm">Another slide with different styling</p>
+              </div>
+              <div class="w-full h-full bg-gradient-to-r from-purple-500 to-pink-500 text-white flex flex-col items-center justify-center p-6">
+                <h3 class="text-xl font-bold mb-2">Feature 3</h3>
+                <p class="text-center text-sm">Beautiful gradients and typography</p>
+              </div>
+            </wally-carousel>
+          </div>
+        </div>
+      </div>
+    </section>
+
+    <!-- Properties -->
+    <section class="mb-8">
+      <h2 class="text-lg font-semibold mb-4 text-[#0a0a0a] dark:text-white">Properties</h2>
+      <div class="bg-gray-200 dark:bg-[#121212] p-4 rounded-lg">
+        <pre><code [innerHTML]="propertiesCode" class="text-sm text-[#0a0a0a] dark:text-white"></code></pre>
+      </div>
+    </section>
+
+
+  </div>
+</div>

package/playground/showcase/src/app/pages/documentation/components/carousel-docs/carousel-docs.spec.ts

@@ -0,0 +1,23 @@
+import { ComponentFixture, TestBed } from '@angular/core/testing';
+
+import { CarouselDocs } from './carousel-docs';
+
+describe('CarouselDocs', () => {
+  let component: CarouselDocs;
+  let fixture: ComponentFixture<CarouselDocs>;
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [CarouselDocs]
+    })
+    .compileComponents();
+
+    fixture = TestBed.createComponent(CarouselDocs);
+    component = fixture.componentInstance;
+    fixture.detectChanges();
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+});

package/playground/showcase/src/app/pages/documentation/components/carousel-docs/carousel-docs.ts

@@ -0,0 +1,46 @@
+import { Component } from '@angular/core';
+
+import { Breadcrumb, BreadcrumbItem } from '../../../../components/breadcrumb/breadcrumb';
+import { Carousel } from '../../../../components/carousel/carousel';
+
+import { AiPromptService } from '../../../../core/services/ai-prompt.service';
+import { CarouselCodeExamples } from './carousel-docs.examples';
+import { getFormattedCode } from '../../../../core/utils/prism';
+
+@Component({
+  selector: 'wally-carousel-docs',
+  imports: [
+    Carousel,
+    Breadcrumb
+  ],
+  templateUrl: './carousel-docs.html',
+  styleUrl: './carousel-docs.css'
+})
+export class CarouselDocs {
+  breadcrumbItems: BreadcrumbItem[] = [
+    { label: 'Home', url: '/' },
+    { label: 'Documentation', url: '/documentation' },
+    { label: 'Components', url: '/documentation/components' },
+    { label: 'Carousel' }
+  ];
+
+  // Code examples with highlighting
+  installationCode = getFormattedCode(CarouselCodeExamples.installation, 'bash');
+  importCode = getFormattedCode(CarouselCodeExamples.import, 'typescript');
+  componentImportCode = getFormattedCode(CarouselCodeExamples.componentImport, 'typescript');
+  basicUsageCode = getFormattedCode(CarouselCodeExamples.basicUsage, 'html');
+  customContentCode = getFormattedCode(CarouselCodeExamples.customContent, 'html');
+  propertiesCode = getFormattedCode(CarouselCodeExamples.properties, 'typescript');
+
+  constructor(
+    private aiPromptService: AiPromptService
+  ) { }
+
+  get claudeUrl(): string {
+    return this.aiPromptService.generateClaudeUrl();
+  }
+
+  get chatGptUrl(): string {
+    return this.aiPromptService.generateChatGptUrl();
+  }
+}

package/playground/showcase/src/app/pages/documentation/components/components.html

@@ -60,6 +60,19 @@
       </a>
     </div>
 
+    <div class="bg-gray-200 dark:bg-[#121212] rounded-lg p-4">
+      <div class="flex items-center gap-2 mb-2">
+        <h4 class="text-md font-semibold text-[#0a0a0a] dark:text-white">Carousel</h4>
+        <span class="text-xs bg-yellow-500 text-black px-2 py-1 rounded">Under Construction</span>
+      </div>
+      <p class="text-sm text-gray-700 dark:text-gray-400 mb-3">
+        A smooth carousel component with navigation controls, dot indicators, and elegant transitions using circular buffer algorithm.
+      </p>
+      <a href="/documentation/components/carousel" class="text-blue-500 underline hover:text-blue-700 text-sm">
+        View Documentation
+      </a>
+    </div>
+
     <div class="w-auto h-auto">
       <script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-4944285767597175"
         crossorigin="anonymous"></script>

package/playground/showcase/src/app/pages/documentation/components/components.routes.ts

@@ -16,5 +16,9 @@ export const componentsRoutes: Routes = [
     {
         path: 'input',
         loadComponent: () => import('./input-docs/input-docs').then(m => m.InputDocs)
+    },
+    {
+        path: 'carousel',
+        loadComponent: () => import('./carousel-docs/carousel-docs').then(m => m.CarouselDocs)
     }
 ];