@shohojdhara/atomix 0.1.30 → 0.2.1

package/src/components/Slider/Slider.stories.tsx

@@ -0,0 +1,241 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { fn } from '@storybook/test';
+import { SliderSlide } from '../../lib/types/components';
+import { Slider } from './Slider';
+
+const meta = {
+  title: 'Components/Slider',
+  component: Slider,
+  parameters: {
+    layout: 'padded',
+  },
+  argTypes: {
+    slides: { control: 'object' },
+    slidesToShow: { control: { type: 'number', min: 1, max: 5 } },
+    slidesToScroll: { control: { type: 'number', min: 1, max: 3 } },
+    spaceBetween: { control: { type: 'number', min: 0, max: 50 } },
+    centeredSlides: { control: 'boolean' },
+    loop: { control: 'boolean' },
+    initialSlide: { control: { type: 'number', min: 0 } },
+    direction: { control: { type: 'select' }, options: ['horizontal', 'vertical'] },
+    speed: { control: { type: 'number', min: 100, max: 2000 } },
+    autoplay: { control: 'boolean' },
+    navigation: { control: 'boolean' },
+    pagination: { control: 'boolean' },
+    height: { control: { type: 'number', min: 200, max: 800 } },
+    width: { control: 'text' },
+    grabCursor: { control: 'boolean' },
+    keyboard: { control: 'boolean' },
+    mousewheel: { control: 'boolean' },
+    freeMode: { control: 'boolean' },
+  },
+} satisfies Meta<typeof Slider>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+const basicSlides: SliderSlide[] = [
+  {
+    id: '1',
+    content: (
+      <div
+        style={{
+          background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
+          width: '100%',
+          height: '100%',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+          color: 'white',
+          fontSize: '24px',
+          fontWeight: 'bold',
+        }}
+      >
+        Slide 1
+      </div>
+    ),
+  },
+  {
+    id: '2',
+    content: (
+      <div
+        style={{
+          background: 'linear-gradient(135deg, #f093fb 0%, #f5576c 100%)',
+          width: '100%',
+          height: '100%',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+          color: 'white',
+          fontSize: '24px',
+          fontWeight: 'bold',
+        }}
+      >
+        Slide 2
+      </div>
+    ),
+  },
+  {
+    id: '3',
+    content: (
+      <div
+        style={{
+          background: 'linear-gradient(135deg, #4facfe 0%, #00f2fe 100%)',
+          width: '100%',
+          height: '100%',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+          color: 'white',
+          fontSize: '24px',
+          fontWeight: 'bold',
+        }}
+      >
+        Slide 3
+      </div>
+    ),
+  },
+  {
+    id: '4',
+    content: (
+      <div
+        style={{
+          background: 'linear-gradient(135deg, #43e97b 0%, #38f9d7 100%)',
+          width: '100%',
+          height: '100%',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+          color: 'white',
+          fontSize: '24px',
+          fontWeight: 'bold',
+        }}
+      >
+        Slide 4
+      </div>
+    ),
+  },
+  {
+    id: '5',
+    content: (
+      <div
+        style={{
+          background: 'linear-gradient(135deg, #fa709a 0%, #fee140 100%)',
+          width: '100%',
+          height: '100%',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+          color: 'white',
+          fontSize: '24px',
+          fontWeight: 'bold',
+        }}
+      >
+        Slide 5
+      </div>
+    ),
+  },
+];
+
+const imageSlides: SliderSlide[] = [
+  {
+    id: '1',
+    image: 'https://picsum.photos/800/400?random=1',
+    alt: 'Random image 1',
+    content: null,
+  },
+  {
+    id: '2',
+    image: 'https://picsum.photos/800/400?random=2',
+    alt: 'Random image 2',
+    content: null,
+  },
+  {
+    id: '3',
+    image: 'https://picsum.photos/800/400?random=3',
+    alt: 'Random image 3',
+    content: null,
+  },
+  {
+    id: '4',
+    image: 'https://picsum.photos/800/400?random=4',
+    alt: 'Random image 4',
+    content: null,
+  },
+];
+
+export const Basic: Story = {
+  args: {
+    slides: basicSlides,
+    height: 300,
+    onInit: fn(),
+    slidesToShow: 1,
+    loop: true,
+  },
+};
+
+export const WithNavigation: Story = {
+  args: {
+    slides: basicSlides,
+    height: 300,
+    width: '600px',
+    navigation: true,
+    onInit: fn(),
+  },
+};
+
+export const WithPagination: Story = {
+  args: {
+    slides: basicSlides,
+    height: 300,
+    width: '600px',
+    pagination: true,
+    onInit: fn(),
+  },
+};
+
+export const ImageSlider: Story = {
+  args: {
+    slides: imageSlides,
+    height: 400,
+    width: '800px',
+    navigation: true,
+    pagination: true,
+    onInit: fn(),
+  },
+};
+
+export const MultipleSlides: Story = {
+  args: {
+    slides: basicSlides,
+    height: 250,
+    width: '800px',
+    slidesToShow: 3,
+    spaceBetween: 20,
+    navigation: true,
+    onInit: fn(),
+  },
+};
+
+export const Autoplay: Story = {
+  args: {
+    slides: basicSlides,
+    height: 300,
+    width: '600px',
+    autoplay: { delay: 3000 },
+    navigation: true,
+    pagination: true,
+    onInit: fn(),
+  },
+};
+
+export const Vertical: Story = {
+  args: {
+    slides: basicSlides.slice(0, 3),
+    height: 400,
+    width: '300px',
+    direction: 'vertical',
+    navigation: true,
+    onInit: fn(),
+  },
+};

package/src/components/Slider/Slider.tsx

@@ -0,0 +1,225 @@
+import { forwardRef, useMemo } from 'react';
+import { useSlider } from '../../lib/composables/useSlider';
+import { SliderProps } from '../../lib/types/components';
+
+export const Slider = forwardRef<HTMLDivElement, SliderProps>((props, ref) => {
+  const {
+    slides = [],
+    height = 300,
+    width = '100%',
+    slidesToShow = 1,
+    spaceBetween = 0,
+    loop = false,
+    initialSlide = 0,
+    direction = 'horizontal',
+    speed = 300,
+    allowTouchMove = true,
+    threshold = 50,
+    grabCursor = true,
+    navigation,
+    pagination,
+    className,
+    onSlideChange,
+    ...rest
+  } = props;
+
+  if (!slides || slides.length === 0) {
+    return (
+      <div className="c-slider c-slider--empty" style={{ height, width }}>
+        <div className="c-slider__empty-message">No slides available</div>
+      </div>
+    );
+  }
+
+  const slider = useSlider({
+    slides,
+    slidesToShow,
+    spaceBetween,
+    loop,
+    initialSlide,
+    direction,
+    speed,
+    allowTouchMove,
+    threshold,
+    onSlideChange,
+  });
+
+  const {
+    containerRef,
+    wrapperRef,
+    allSlides,
+    realIndex,
+    translateValue,
+    slideWidth,
+    transitioning,
+    touching,
+    slideNext,
+    slidePrev,
+    goToSlide,
+    canSlideNext,
+    canSlidePrev,
+    handleTouchStart,
+    handleTouchMove,
+    handleTouchEnd,
+    loopedSlides,
+  } = slider;
+
+  const totalWrapperWidth = useMemo(() => {
+    if (slideWidth === 0) return 0;
+    return allSlides.length * (slideWidth + spaceBetween) - spaceBetween;
+  }, [allSlides.length, slideWidth, spaceBetween]);
+
+  const containerClasses = [
+    'c-slider',
+    direction === 'vertical' && 'c-slider--vertical',
+    grabCursor && 'c-slider--grab-cursor',
+    touching && 'c-slider--grabbing',
+    loop && 'c-slider--loop',
+    className,
+  ]
+    .filter(Boolean)
+    .join(' ');
+
+  return (
+    <div
+      ref={ref || containerRef}
+      className={containerClasses}
+      style={{
+        height: typeof height === 'number' ? `${height}px` : height,
+        width: typeof width === 'number' ? `${width}px` : width,
+        overflow: 'hidden',
+        position: 'relative',
+        cursor: grabCursor && !touching ? 'grab' : touching ? 'grabbing' : 'default',
+        ...(rest as any).style,
+      }}
+      onTouchStart={handleTouchStart}
+      onTouchMove={handleTouchMove}
+      onTouchEnd={handleTouchEnd}
+      onMouseDown={handleTouchStart}
+      onMouseMove={handleTouchMove}
+      onMouseUp={handleTouchEnd}
+      onMouseLeave={handleTouchEnd}
+    >
+      <div
+        ref={wrapperRef}
+        className="c-slider__wrapper"
+        style={{
+          display: 'flex',
+          flexDirection: direction === 'vertical' ? 'column' : 'row',
+          width: direction === 'horizontal' ? `${totalWrapperWidth}px` : '100%',
+          height: direction === 'vertical' ? `${totalWrapperWidth}px` : '100%',
+          transform:
+            direction === 'horizontal'
+              ? `translateX(${translateValue}px)`
+              : `translateY(${translateValue}px)`,
+          transition:
+            transitioning && !slider.repositioningRef?.current
+              ? `transform ${speed}ms ease-out`
+              : 'none',
+          willChange: 'transform',
+        }}
+      >
+        {allSlides.map((slide, index) => (
+          <div
+            key={slide.id || index}
+            className={[
+              'c-slider__slide',
+              (() => {
+                if (!loop) return index === realIndex;
+                // For triple array: check if this slide index matches current real index
+                return index % slides.length === realIndex;
+              })() && 'c-slider__slide--active',
+              (slide as any).isClone && 'c-slider__slide--duplicate',
+            ]
+              .filter(Boolean)
+              .join(' ')}
+            style={{
+              width: direction === 'vertical' ? '100%' : `${slideWidth}px`,
+              height: direction === 'vertical' ? `${slideWidth}px` : '100%',
+              flexShrink: 0,
+              marginRight:
+                direction === 'horizontal' && index < allSlides.length - 1
+                  ? `${spaceBetween}px`
+                  : 0,
+              marginBottom:
+                direction === 'vertical' && index < allSlides.length - 1 ? `${spaceBetween}px` : 0,
+            }}
+          >
+            {slide.video ? (
+              <video
+                src={slide.video.src}
+                poster={slide.video.poster}
+                autoPlay={slide.video.autoplay}
+                loop={slide.video.loop}
+                muted={slide.video.muted}
+                style={{ width: '100%', height: '100%', objectFit: 'cover' }}
+              />
+            ) : slide.backgroundImage ? (
+              <div
+                style={{
+                  width: '100%',
+                  height: '100%',
+                  backgroundImage: `url(${slide.backgroundImage})`,
+                  backgroundSize: 'cover',
+                  backgroundPosition: 'center',
+                }}
+              >
+                {slide.content}
+              </div>
+            ) : slide.image ? (
+              <img
+                src={slide.image}
+                alt={slide.alt || slide.title || ''}
+                style={{ width: '100%', height: '100%', objectFit: 'cover' }}
+              />
+            ) : (
+              slide.content
+            )}
+
+            {(slide.title || slide.description) && (
+              <div className="c-slider__slide-content">
+                {slide.title && <h3>{slide.title}</h3>}
+                {slide.description && <p>{slide.description}</p>}
+              </div>
+            )}
+          </div>
+        ))}
+      </div>
+
+      {navigation && (
+        <div className="c-slider__navigation">
+          <button
+            type="button"
+            className="c-slider__navigation-prev"
+            onClick={slidePrev}
+            disabled={!canSlidePrev}
+            aria-label="Previous slide"
+          />
+          <button
+            type="button"
+            className="c-slider__navigation-next"
+            onClick={slideNext}
+            disabled={!canSlideNext}
+            aria-label="Next slide"
+          />
+        </div>
+      )}
+
+      {pagination && (
+        <div className="c-slider__pagination">
+          {slides.map((_, index) => (
+            <button
+              key={index}
+              type="button"
+              className={`c-slider__pagination-bullet ${index === realIndex ? 'c-slider__pagination-bullet--active' : ''}`}
+              onClick={() => goToSlide(index)}
+              aria-label={`Go to slide ${index + 1}`}
+            />
+          ))}
+        </div>
+      )}
+    </div>
+  );
+});
+
+Slider.displayName = 'Slider';

package/src/components/Slider/index.ts

@@ -0,0 +1,24 @@
+/**
+ * Slider component exports
+ * Following Atomix design system patterns
+ */
+
+export type {
+  SliderProps,
+  SliderRefs,
+  SliderSlide,
+  SliderState,
+  SliderAutoplay,
+  SliderPagination,
+  SliderNavigation,
+  SliderScrollbar,
+  SliderEffect,
+  SliderThumbs,
+  SliderZoom,
+  SliderLazy,
+  SliderVirtual,
+  SliderBreakpoint,
+} from '../../lib/types/components';
+export { Slider } from './Slider';
+export { useSlider } from '../../lib/composables/useSlider';
+export type { UseSliderOptions, UseSliderReturn } from '../../lib/composables/useSlider';

package/src/components/Spinner/Spinner.stories.tsx

@@ -0,0 +1,65 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { Spinner } from './Spinner';
+
+const meta = {
+  title: 'Components/Spinner',
+  component: Spinner,
+  parameters: {
+    layout: 'centered',
+  },
+  argTypes: {
+    variant: {
+      control: { type: 'select' },
+      options: ['primary', 'secondary', 'success', 'info', 'warning', 'error', 'light', 'dark'],
+      description: 'The color variant of the spinner',
+    },
+    size: {
+      control: { type: 'select' },
+      options: ['sm', 'md', 'lg'],
+      description: 'The size of the spinner',
+    },
+    fullscreen: {
+      control: 'boolean',
+      description: 'Whether the spinner should be centered and fixed in the viewport',
+    },
+  },
+} satisfies Meta<typeof Spinner>;
+
+export default meta;
+type Story = StoryObj<typeof Spinner>;
+
+// Default Spinner
+export const Default: Story = {
+  args: {
+    variant: 'primary',
+    size: 'md',
+    fullscreen: false,
+  },
+};
+
+// Size Variants
+export const Sizes: Story = {
+  render: () => (
+    <div className="u-d-flex u-flex-wrap u-gap-3 u-align-items-center">
+      <Spinner size="sm" />
+      <Spinner size="md" />
+      <Spinner size="lg" />
+    </div>
+  ),
+};
+
+// Color Variants
+export const ColorVariants: Story = {
+  render: () => (
+    <div className="u-d-flex u-flex-wrap u-gap-3 u-align-items-center">
+      <Spinner variant="primary" />
+      <Spinner variant="secondary" />
+      <Spinner variant="success" />
+      <Spinner variant="info" />
+      <Spinner variant="warning" />
+      <Spinner variant="error" />
+      <Spinner variant="light" />
+      <Spinner variant="dark" />
+    </div>
+  ),
+};

package/src/components/Spinner/Spinner.tsx

@@ -0,0 +1,36 @@
+import React from 'react';
+import { SpinnerProps } from '../../lib/types/components';
+import { useSpinner } from '../../lib/composables/useSpinner';
+import { SPINNER } from '../../lib/constants/components';
+
+export const Spinner: React.FC<SpinnerProps> = ({
+  size = 'md',
+  variant = 'primary',
+  fullscreen = false,
+  className = '',
+}) => {
+  const { generateSpinnerClass } = useSpinner({
+    size,
+    variant,
+    fullscreen,
+  });
+
+  const spinnerClass = generateSpinnerClass({
+    size,
+    variant,
+    fullscreen,
+    className,
+  });
+
+  return (
+    <div className={spinnerClass} role="status">
+      <span className={SPINNER.VISUALLY_HIDDEN}>Loading...</span>
+    </div>
+  );
+};
+
+export type { SpinnerProps };
+
+Spinner.displayName = 'Spinner';
+
+export default Spinner;

package/src/components/Spinner/index.ts

@@ -0,0 +1,2 @@
+export { Spinner } from './Spinner';
+export type { SpinnerProps } from './Spinner';