src/components/cardStack/CardList.tsx

@@ -1,7 +1,7 @@
-import React, { useRef, useEffect, useState } from 'react';
+import React, { useRef } from 'react';
 import { useCardAnimation, UseCardAnimationOptions } from '@/hooks/useCardAnimation';
 
-interface CardListProps {
+export interface CardListProps {
   children: React.ReactNode;
   containerClassName?: string;
 }

src/components/cardStack/layouts/carousels/AutoCarousel.tsx

@@ -1,12 +1,31 @@
 import React, { useRef } from 'react';
 import { useCardAnimation, UseCardAnimationOptions } from '@/hooks/useCardAnimation';
 
-interface AutoCarouselProps {
+export interface AutoCarouselProps {
   children: React.ReactNode;
+  title?: string;
+  description?: string;
+  textboxLayout?: string;
+  animationType?: string;
+  className?: string;
+  carouselClassName?: string;
   containerClassName?: string;
+  itemClassName?: string;
+  ariaLabel?: string;
+  showTextBox?: boolean;
+  tag?: string;
+  tagIcon?: any;
+  tagAnimation?: string;
+  buttons?: Array<{ text: string; onClick?: () => void; href?: string }>;
+  buttonAnimation?: string;
+  titleSegments?: Array<{ type: 'text'; content: string } | { type: 'image'; src: string; alt?: string }>;
 }
 
-export const AutoCarousel: React.FC<AutoCarouselProps> = ({ children, containerClassName = '' }) => {
+export const AutoCarousel: React.FC<AutoCarouselProps> = ({
+  children,
+  containerClassName = '',
+  ...props
+}) => {
   const containerRef = useRef<HTMLDivElement>(null);
   const itemRefs = useRef<(HTMLDivElement | null)[]>([]);
   const bottomContentRef = useRef<HTMLDivElement>(null);

src/components/cardStack/layouts/timelines/TimelineHorizontalCardStack.tsx

@@ -1,32 +1,25 @@
-"use client";
+import React, { useRef } from 'react';
+import { useCardAnimation, UseCardAnimationOptions } from '@/hooks/useCardAnimation';
 
-import React, { Children, useCallback } from "react";
-import { cls } from "@/lib/utils";
-import CardStackTextBox from "../../CardStackTextBox";
-import { useTimelineHorizontal, type MediaItem } from "../../hooks/useTimelineHorizontal";
-import MediaContent from "@/components/shared/MediaContent";
-import type { LucideIcon } from "lucide-react";
-import type { ButtonConfig, ButtonAnimationType, TitleSegment, TextboxLayout, InvertedBackground } from "../../types";
-
-interface TimelineHorizontalCardStackProps {
+export interface TimelineHorizontalCardStackProps {
   children: React.ReactNode;
-  title: string;
-  titleSegments?: TitleSegment[];
-  description: string;
+  title?: string;
+  description?: string;
   tag?: string;
-  tagIcon?: LucideIcon;
-  tagAnimation?: ButtonAnimationType;
-  buttons?: ButtonConfig[];
-  buttonAnimation?: ButtonAnimationType;
-  textboxLayout: TextboxLayout;
-  useInvertedBackground?: InvertedBackground;
-  mediaItems?: MediaItem[];
-  className?: string;
+  textboxLayout?: string;
+  animationType?: string;
   containerClassName?: string;
+  mediaItems?: Array<{ imageSrc?: string; videoSrc?: string; imageAlt?: string; videoAriaLabel?: string }>;
+  titleSegments?: Array<{ type: 'text'; content: string } | { type: 'image'; src: string; alt?: string }>;
+  buttons?: Array<{ text: string; onClick?: () => void; href?: string }>;
+  buttonAnimation?: string;
+  tagIcon?: any;
+  tagAnimation?: string;
+  useInvertedBackground?: boolean;
+  ariaLabel?: string;
+  className?: string;
   textBoxClassName?: string;
   titleClassName?: string;
-  titleImageWrapperClassName?: string;
-  titleImageClassName?: string;
   descriptionClassName?: string;
   tagClassName?: string;
   buttonContainerClassName?: string;
@@ -36,140 +29,28 @@ interface TimelineHorizontalCardStackProps {
   progressBarClassName?: string;
   mediaContainerClassName?: string;
   mediaClassName?: string;
-  ariaLabel?: string;
 }
 
-const TimelineHorizontalCardStack = ({
+export const TimelineHorizontalCardStack: React.FC<TimelineHorizontalCardStackProps> = ({
   children,
-  title,
-  titleSegments,
-  description,
-  tag,
-  tagIcon,
-  tagAnimation,
-  buttons,
-  buttonAnimation,
-  textboxLayout,
-  useInvertedBackground,
-  mediaItems,
-  className = "",
-  containerClassName = "",
-  textBoxClassName = "",
-  titleClassName = "",
-  titleImageWrapperClassName = "",
-  titleImageClassName = "",
-  descriptionClassName = "",
-  tagClassName = "",
-  buttonContainerClassName = "",
-  buttonClassName = "",
-  buttonTextClassName = "",
-  cardClassName = "",
-  progressBarClassName = "",
-  mediaContainerClassName = "",
-  mediaClassName = "",
-  ariaLabel = "Timeline section",
-}: TimelineHorizontalCardStackProps) => {
-  const childrenArray = Children.toArray(children);
-  const itemCount = childrenArray.length;
+  containerClassName = '',
+  ...props
+}) => {
+  const containerRef = useRef<HTMLDivElement>(null);
+  const itemRefs = useRef<(HTMLDivElement | null)[]>([]);
 
-  const { activeIndex, progressRefs, handleItemClick, imageOpacity, currentMediaSrc } = useTimelineHorizontal({
-    itemCount,
-    mediaItems,
-  });
+  const animationOptions: UseCardAnimationOptions = {
+    containerRef,
+    itemRefs,
+  };
 
-  const getGridColumns = useCallback(() => {
-    if (itemCount === 2) return "md:grid-cols-2";
-    if (itemCount === 3) return "md:grid-cols-3";
-    return "md:grid-cols-4";
-  }, [itemCount]);
-
-  const getItemOpacity = useCallback(
-    (index: number) => {
-      return index <= activeIndex ? "opacity-100" : "opacity-50";
-    },
-    [activeIndex]
-  );
+  const { } = useCardAnimation(animationOptions);
 
   return (
-    <section
-      className={cls(
-        "relative py-20 w-full",
-        useInvertedBackground && "bg-foreground",
-        className
-      )}
-      aria-label={ariaLabel}
-    >
-      <div className={cls("w-content-width mx-auto flex flex-col gap-6", containerClassName)}>
-        <CardStackTextBox
-          title={title}
-          titleSegments={titleSegments}
-          description={description}
-          tag={tag}
-          tagIcon={tagIcon}
-          tagAnimation={tagAnimation}
-          buttons={buttons}
-          buttonAnimation={buttonAnimation}
-          textboxLayout={textboxLayout}
-          useInvertedBackground={useInvertedBackground}
-          textBoxClassName={textBoxClassName}
-          titleClassName={titleClassName}
-          titleImageWrapperClassName={titleImageWrapperClassName}
-          titleImageClassName={titleImageClassName}
-          descriptionClassName={descriptionClassName}
-          tagClassName={tagClassName}
-          buttonContainerClassName={buttonContainerClassName}
-          buttonClassName={buttonClassName}
-          buttonTextClassName={buttonTextClassName}
-        />
-        {mediaItems && mediaItems.length > 0 && (
-          <div className={cls("relative card rounded-theme-capped overflow-hidden aspect-square md:aspect-[17/9]", mediaContainerClassName)}>
-            <div
-              className="absolute inset-6 z-1 transition-opacity duration-300 overflow-hidden"
-              style={{ opacity: imageOpacity }}
-            >
-              <MediaContent
-                imageSrc={currentMediaSrc.imageSrc}
-                videoSrc={currentMediaSrc.videoSrc}
-                imageAlt={mediaItems[activeIndex]?.imageAlt}
-                videoAriaLabel={mediaItems[activeIndex]?.videoAriaLabel}
-                imageClassName={cls("w-full h-full object-cover", mediaClassName)}
-              />
-            </div>
-          </div>
-        )}
-        <div className={cls("relative grid grid-cols-1 gap-6 md:gap-6", getGridColumns())}>
-          {Children.map(childrenArray, (child, index) => (
-            <div
-              key={index}
-              className={cls(
-                "card rounded-theme-capped p-6 flex flex-col justify-between gap-6 transition-all duration-300",
-                index === activeIndex ? "cursor-default" : "cursor-pointer hover:shadow-lg",
-                getItemOpacity(index),
-                cardClassName
-              )}
-              onClick={() => handleItemClick(index)}
-            >
-              {child}
-              <div className="relative w-full h-px overflow-hidden">
-                <div className="absolute z-0 w-full h-full bg-foreground/20" />
-                <div
-                  ref={(el) => {
-                    if (el !== null) {
-                      progressRefs.current[index] = el;
-                    }
-                  }}
-                  className={cls("absolute z-10 h-full w-full bg-foreground origin-left", progressBarClassName)}
-                  style={{ transform: "scaleX(0)" }}
-                />
-              </div>
-            </div>
-          ))}
-        </div>
-      </div>
-    </section>
+    <div ref={containerRef} className={containerClassName}>
+      {children}
+    </div>
   );
 };
 
-TimelineHorizontalCardStack.displayName = "TimelineHorizontalCardStack";
-
-export default React.memo(TimelineHorizontalCardStack);
+export default TimelineHorizontalCardStack;

src/components/cardStack/layouts/timelines/TimelinePhoneView.tsx

@@ -1,12 +1,42 @@
 import React, { useRef } from 'react';
 import { useCardAnimation, UseCardAnimationOptions } from '@/hooks/useCardAnimation';
 
-interface TimelinePhoneViewProps {
-  children: React.ReactNode;
-  containerClassName?: string;
+export interface TimelinePhoneViewItem {
+  [key: string]: any;
 }
 
-export const TimelinePhoneView: React.FC<TimelinePhoneViewProps> = ({ children, containerClassName = '' }) => {
+export interface TimelinePhoneViewProps {
+  children: React.ReactNode;
+  showTextBox?: boolean;
+  showDivider?: boolean;
+  title?: string;
+  titleSegments?: Array<{ type: 'text'; content: string } | { type: 'image'; src: string; alt?: string }>;
+  description?: string;
+  tag?: string;
+  tagIcon?: any;
+  tagAnimation?: string;
+  buttons?: Array<{ text: string; onClick?: () => void; href?: string }>;
+  buttonAnimation?: string;
+  textboxLayout?: string;
+  animationType?: string;
+  useInvertedBackground?: boolean;
+  ariaLabel?: string;
+  className?: string;
+  containerClassName?: string;
+  textBoxClassName?: string;
+  titleClassName?: string;
+  descriptionClassName?: string;
+  tagClassName?: string;
+  buttonContainerClassName?: string;
+  buttonClassName?: string;
+  buttonTextClassName?: string;
+}
+
+export const TimelinePhoneView: React.FC<TimelinePhoneViewProps> = ({
+  children,
+  containerClassName = '',
+  ...props
+}) => {
   const containerRef = useRef<HTMLDivElement>(null);
   const itemRefs = useRef<(HTMLDivElement | null)[]>([]);
 

src/components/cardStack/layouts/timelines/TimelineProcessFlow.tsx

@@ -1,12 +1,37 @@
 import React, { useRef } from 'react';
 import { useCardAnimation, UseCardAnimationOptions } from '@/hooks/useCardAnimation';
 
-interface TimelineProcessFlowProps {
+export interface TimelineProcessFlowProps {
   children: React.ReactNode;
+  title?: string;
+  titleSegments?: Array<{ type: 'text'; content: string } | { type: 'image'; src: string; alt?: string }>;
+  description?: string;
+  tag?: string;
+  tagIcon?: any;
+  tagAnimation?: string;
+  buttons?: Array<{ text: string; onClick?: () => void; href?: string }>;
+  buttonAnimation?: string;
+  textboxLayout?: string;
+  animationType?: string;
+  useInvertedBackground?: boolean;
+  ariaLabel?: string;
+  className?: string;
   containerClassName?: string;
+  textBoxClassName?: string;
+  titleClassName?: string;
+  descriptionClassName?: string;
+  tagClassName?: string;
+  buttonContainerClassName?: string;
+  buttonClassName?: string;
+  buttonTextClassName?: string;
+  gapClassName?: string;
 }
 
-export const TimelineProcessFlow: React.FC<TimelineProcessFlowProps> = ({ children, containerClassName = '' }) => {
+export const TimelineProcessFlow: React.FC<TimelineProcessFlowProps> = ({
+  children,
+  containerClassName = '',
+  ...props
+}) => {
   const containerRef = useRef<HTMLDivElement>(null);
   const itemRefs = useRef<(HTMLDivElement | null)[]>([]);
 

src/components/shared/Dashboard.tsx

@@ -1,12 +1,45 @@
 import React, { useRef } from 'react';
 import { useCardAnimation, UseCardAnimationOptions } from '@/hooks/useCardAnimation';
 
-interface DashboardProps {
-  title: string;
-  containerClassName?: string;
+export interface DashboardStat {
+  label: string;
+  value: string | number;
 }
 
-export const Dashboard: React.FC<DashboardProps> = ({ title, containerClassName = '' }) => {
+export interface DashboardSidebarItem {
+  label: string;
+  icon?: any;
+  active?: boolean;
+}
+
+export interface DashboardListItem {
+  label: string;
+  value?: string;
+}
+
+export interface DashboardProps {
+  title?: string;
+  stats?: DashboardStat[];
+  logoIcon?: any;
+  sidebarItems?: DashboardSidebarItem[];
+  searchPlaceholder?: string;
+  buttons?: Array<{ text: string; onClick?: () => void; href?: string }>;
+  chartTitle?: string;
+  chartData?: Array<{ label: string; value: number }>;
+  listItems?: DashboardListItem[];
+  containerClassName?: string;
+  headerClassName?: string;
+  statsClassName?: string;
+  sidebarClassName?: string;
+  contentClassName?: string;
+  listClassName?: string;
+}
+
+export const Dashboard: React.FC<DashboardProps> = ({
+  title,
+  containerClassName = '',
+  ...props
+}) => {
   const containerRef = useRef<HTMLDivElement>(null);
   const itemRefs = useRef<(HTMLDivElement | null)[]>([]);
 
@@ -19,7 +52,7 @@ export const Dashboard: React.FC<DashboardProps> = ({ title, containerClassName
 
   return (
     <div ref={containerRef} className={containerClassName}>
-      <h1>{title}</h1>
+      {title && <h1>{title}</h1>}
     </div>
   );
 };