react-styled-slider-component 0.1.0

package/README.md

@@ -0,0 +1,74 @@
+# React Styled Slider Component
+
+A customizable and reusable slider component built with React and styled-components. This component allows developers to easily implement a slider/carousel with various configuration options, such as the number of visible slides, navigation arrows, dots, and different directions.
+
+## Installation
+
+To install the package, use npm or yarn:
+
+```bash
+npm install react-styled-slider-component
+```
+
+## Usage
+
+Here's how to use the slider component in your React application:
+
+```tsx
+import React from 'react';
+import Slider from 'react-styled-slider-component';
+
+const App: React.FC = () => {
+  return (
+    <div>
+      <Slider
+        visibleSlides={2}
+        showDots={true}
+        showArrows={true}
+        dotsPosition="bottom"
+        slideStep={1}
+        direction="horizontal"
+        arrowStyle="minimal"
+      >
+        <div style={{ backgroundColor: 'red', height: '200px' }}>Slide 1</div>
+        <div style={{ backgroundColor: 'blue', height: '200px' }}>Slide 2</div>
+        <div style={{ backgroundColor: 'green', height: '200px' }}>Slide 3</div>
+        <div style={{ backgroundColor: 'yellow', height: '200px' }}>Slide 4</div>
+        <div style={{ backgroundColor: 'red', height: '200px' }}>Slide 5</div>
+        <div style={{ backgroundColor: 'blue', height: '200px' }}>Slide 6</div>
+        <div style={{ backgroundColor: 'green', height: '200px' }}>Slide 7</div>
+        <div style={{ backgroundColor: 'yellow', height: '200px' }}>Slide 8</div>
+      </Slider>
+    </div>
+  );
+};
+
+export default App;
+```
+
+## Props
+
+The `Slider` component accepts the following props:
+
+| Prop Name       | Type                                               | Default   | Description                                                                 |
+| --------------- | -------------------------------------------------- | --------- | --------------------------------------------------------------------------- |
+| `children`      | `React.ReactNode[]`                                | -         | The slides to be displayed in the slider.                                   |
+| `visibleSlides` | `number`                                           | `1`       | Number of slides visible at one time.                                       |
+| `showDots`      | `boolean`                                          | `true`    | Whether to show navigation dots below the slider.                           |
+| `showArrows`    | `boolean`                                          | `true`    | Whether to show navigation arrows on the slider.                            |
+| `dotsPosition`  | `'top' ,'bottom' , 'left' , 'right'`              | `'bottom'` | Position of the navigation dots.                                            |
+| `slideStep`     | `number`                                           | `1`       | Number of slides to move on each navigation action.                         |
+| `direction`     | `'horizontal' , 'vertical'`                        | `'horizontal'` | Direction of the slider, either horizontal or vertical.                    |
+| `arrowStyle`    | `'minimal' , 'filled' , 'outlined'`                | `'minimal'` | Style of the navigation arrows.                                             |
+| `arrowColor`    | `'black' , 'white'`                                | `'black'` | Color of the navigation arrows.                                             |
+
+
+## Customization
+
+The slider component uses `styled-components` for styling, making it highly customizable. You can override the styles by extending the styled components used in the slider.
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request if you have any suggestions or improvements.
+
+

package/dist/App.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const App: React.FC;
+export default App;

package/dist/App.js

@@ -0,0 +1,17 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Slider from './components/Slider';
+var App = function () {
+    return (_jsx("div", { children: _jsxs(Slider, __assign({ visibleSlides: 2, showDots: true, showArrows: true, dotsPosition: "bottom", slideStep: 1, direction: "horizontal", arrowStyle: "minimal" }, { children: [_jsx("div", __assign({ style: { backgroundColor: 'red', height: '200px' } }, { children: "Slide 1" })), _jsx("div", __assign({ style: { backgroundColor: 'blue', height: '200px' } }, { children: "Slide 2" })), _jsx("div", __assign({ style: { backgroundColor: 'green', height: '200px' } }, { children: "Slide 3" })), _jsx("div", __assign({ style: { backgroundColor: 'yellow', height: '200px' } }, { children: "Slide 4" })), _jsx("div", __assign({ style: { backgroundColor: 'red', height: '200px' } }, { children: "Slide 5" })), _jsx("div", __assign({ style: { backgroundColor: 'blue', height: '200px' } }, { children: "Slide 6" })), _jsx("div", __assign({ style: { backgroundColor: 'green', height: '200px' } }, { children: "Slide 7" })), _jsx("div", __assign({ style: { backgroundColor: 'yellow', height: '200px' } }, { children: "Slide 8" }))] })) }));
+};
+export default App;

package/dist/App.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/App.test.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render, screen } from '@testing-library/react';
+import App from './App';
+test('renders learn react link', function () {
+    render(_jsx(App, {}));
+    var linkElement = screen.getByText(/learn react/i);
+    expect(linkElement).toBeInTheDocument();
+});

package/dist/components/Slider.d.ts

@@ -0,0 +1,14 @@
+import React from "react";
+interface SliderProps {
+    children: React.ReactNode[];
+    visibleSlides?: number;
+    showDots?: boolean;
+    showArrows?: boolean;
+    dotsPosition?: "top" | "bottom" | "left" | "right";
+    slideStep?: number;
+    direction?: "horizontal" | "vertical";
+    arrowStyle?: "minimal" | "filled" | "outlined";
+    arrowColor?: "black" | "white";
+}
+declare const Slider: React.FC<SliderProps>;
+export default Slider;

package/dist/components/Slider.js

@@ -0,0 +1,59 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { SliderWrapper, SlideTrack, Slide, DotsWrapper, Dot, Arrow, } from "./SliderStyles.styles";
+var Slider = function (_a) {
+    var children = _a.children, _b = _a.visibleSlides, visibleSlides = _b === void 0 ? 1 : _b, _c = _a.showDots, showDots = _c === void 0 ? true : _c, _d = _a.showArrows, showArrows = _d === void 0 ? true : _d, _e = _a.dotsPosition, dotsPosition = _e === void 0 ? "bottom" : _e, _f = _a.slideStep, slideStep = _f === void 0 ? 1 : _f, _g = _a.direction, direction = _g === void 0 ? "horizontal" : _g, _h = _a.arrowStyle, arrowStyle = _h === void 0 ? "minimal" : _h, _j = _a.arrowColor, arrowColor = _j === void 0 ? "black" : _j;
+    var _k = useState(0), currentIndex = _k[0], setCurrentIndex = _k[1];
+    var totalSlides = children.length;
+    // Maximum index value, preventing overflow when navigating through slides.
+    var maxIndex = totalSlides - visibleSlides;
+    // Calculate the number of dots based on the total number of slides and the number of visible slides.
+    var numberOfDots = Math.ceil((totalSlides - visibleSlides + 1) / slideStep);
+    var isHorizontal = direction === "horizontal";
+    var goToNext = function () {
+        setCurrentIndex(function (prevIndex) { return Math.min(prevIndex + slideStep, maxIndex); });
+    };
+    var goToPrev = function () {
+        setCurrentIndex(function (prevIndex) { return Math.max(prevIndex - slideStep, 0); });
+    };
+    var goToSlide = function (index) {
+        setCurrentIndex(index);
+    };
+    var slidePercentage = isHorizontal
+        ? 100 / visibleSlides
+        : 100 / totalSlides;
+    return (_jsxs(SliderWrapper, __assign({ direction: direction, style: {
+            height: isHorizontal ? "auto" : "".concat(visibleSlides * 200, "px"),
+            display: isHorizontal ? "block" : "flex",
+            flexDirection: isHorizontal ? "row" : "column",
+        } }, { children: [showArrows && (_jsx(Arrow, __assign({ direction: isHorizontal ? "left" : "up", arrowStyle: arrowStyle, arrowColor: arrowColor, onClick: goToPrev }, { children: isHorizontal ? "<" : "˄" }))), _jsx(SlideTrack, __assign({ style: {
+                    transform: isHorizontal
+                        ? "translateX(-".concat(currentIndex * slidePercentage, "%)")
+                        : "translateY(-".concat((currentIndex * slideStep * 100) / totalSlides, "%)"),
+                    display: "flex",
+                    flexDirection: isHorizontal ? "row" : "column",
+                    width: isHorizontal ? "100%" : "100%",
+                    height: isHorizontal ? "auto" : "".concat(totalSlides * 100, "%"),
+                    transition: "transform 0.3s ease-in-out",
+                    boxSizing: "border-box",
+                } }, { children: children.map(function (child, index) { return (_jsx(Slide, __assign({ visibleSlides: visibleSlides, style: {
+                        flex: isHorizontal ? "0 0 ".concat(slidePercentage, "%") : "1",
+                        width: isHorizontal ? "".concat(slidePercentage, "%") : "100%",
+                        height: isHorizontal ? "auto" : "".concat(100 / totalSlides, "%"),
+                        boxSizing: "border-box",
+                        margin: "0",
+                        padding: "0",
+                    } }, { children: child }), index)); }) })), showArrows && (_jsx(Arrow, __assign({ direction: isHorizontal ? "right" : "down", arrowStyle: arrowStyle, arrowColor: arrowColor, onClick: goToNext }, { children: isHorizontal ? ">" : "˅" }))), showDots && (_jsx(DotsWrapper, __assign({ position: dotsPosition }, { children: Array.from({ length: numberOfDots }).map(function (_, index) { return (_jsx(Dot, { active: index * slideStep === currentIndex, onClick: function () { return goToSlide(index * slideStep); } }, index)); }) })))] })));
+};
+export default Slider;

package/dist/components/SliderStyles.styles.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="react" />
+export declare const SliderWrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
+    direction: 'horizontal' | 'vertical';
+}>> & string;
+export declare const SlideTrack: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+export declare const Slide: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
+    visibleSlides: number;
+}>> & string;
+export declare const DotsWrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
+    position: 'top' | 'bottom' | 'left' | 'right';
+}>> & string;
+export declare const Dot: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
+    active: boolean;
+}>> & string;
+export declare const Arrow: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
+    direction: 'left' | 'right' | 'up' | 'down';
+    arrowStyle: 'minimal' | 'filled' | 'outlined';
+    arrowColor: 'black' | 'white';
+}>> & string;

package/dist/components/SliderStyles.styles.js

@@ -0,0 +1,57 @@
+var __makeTemplateObject = (this && this.__makeTemplateObject) || function (cooked, raw) {
+    if (Object.defineProperty) { Object.defineProperty(cooked, "raw", { value: raw }); } else { cooked.raw = raw; }
+    return cooked;
+};
+import styled from 'styled-components';
+export var SliderWrapper = styled.div(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n  position: relative;\n  width: 100%;\n  overflow: hidden;\n  height: ", "; // Ensure full height for vertical sliders\n\n  ", "\n"], ["\n  position: relative;\n  width: 100%;\n  overflow: hidden;\n  height: ", "; // Ensure full height for vertical sliders\n\n  ", "\n"])), function (_a) {
+    var direction = _a.direction;
+    return (direction === 'vertical' ? '100%' : 'auto');
+}, function (_a) {
+    var direction = _a.direction;
+    return direction === 'vertical' && "\n    display: flex;\n    flex-direction: column;\n  ";
+});
+export var SlideTrack = styled.div(templateObject_2 || (templateObject_2 = __makeTemplateObject(["\n  display: flex;\n  transition: transform 0.3s ease-in-out;\n"], ["\n  display: flex;\n  transition: transform 0.3s ease-in-out;\n"])));
+export var Slide = styled.div(templateObject_3 || (templateObject_3 = __makeTemplateObject(["\n  width: 100%;\n  height: 100%;\n  box-sizing: border-box;\n  margin: 0; \n  padding: 0; \n"], ["\n  width: 100%;\n  height: 100%;\n  box-sizing: border-box;\n  margin: 0; \n  padding: 0; \n"])));
+export var DotsWrapper = styled.div(templateObject_4 || (templateObject_4 = __makeTemplateObject(["\n  display: flex;\n  justify-content: center;\n  flex-direction: ", ";\n  margin-top: ", ";\n  margin-bottom: ", ";\n  margin-left: ", ";\n  margin-right: ", ";\n"], ["\n  display: flex;\n  justify-content: center;\n  flex-direction: ", ";\n  margin-top: ", ";\n  margin-bottom: ", ";\n  margin-left: ", ";\n  margin-right: ", ";\n"])), function (_a) {
+    var position = _a.position;
+    return (position === 'left' || position === 'right' ? 'column' : 'row');
+}, function (_a) {
+    var position = _a.position;
+    return (position === 'top' ? '10px' : '0');
+}, function (_a) {
+    var position = _a.position;
+    return (position === 'bottom' ? '10px' : '0');
+}, function (_a) {
+    var position = _a.position;
+    return (position === 'left' ? '10px' : '0');
+}, function (_a) {
+    var position = _a.position;
+    return (position === 'right' ? '10px' : '0');
+});
+export var Dot = styled.div(templateObject_5 || (templateObject_5 = __makeTemplateObject(["\n  width: 10px;\n  height: 10px;\n  border-radius: 50%;\n  background-color: ", ";\n  margin: 0 5px;\n  cursor: pointer;\n"], ["\n  width: 10px;\n  height: 10px;\n  border-radius: 50%;\n  background-color: ", ";\n  margin: 0 5px;\n  cursor: pointer;\n"])), function (_a) {
+    var active = _a.active;
+    return (active ? 'black' : 'lightgray');
+});
+export var Arrow = styled.div(templateObject_6 || (templateObject_6 = __makeTemplateObject(["\n  position: absolute;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 40px;\n  height: 40px;\n  border-radius: 50%;\n  font-size: 24px;\n  cursor: pointer;\n  z-index: 1;\n  user-select: none;\n\n  // Horizontal arrows\n  ", "\n  ", "\n\n  // Vertical arrows\n  ", "\n  ", "\n\n  // Minimal style: no background or border\n  ", "\n\n  // Filled style: solid background and white arrow\n  ", "\n\n  // Outlined style: transparent background with colored border and arrow\n  ", "\n"], ["\n  position: absolute;\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 40px;\n  height: 40px;\n  border-radius: 50%;\n  font-size: 24px;\n  cursor: pointer;\n  z-index: 1;\n  user-select: none;\n\n  // Horizontal arrows\n  ", "\n  ", "\n\n  // Vertical arrows\n  ", "\n  ", "\n\n  // Minimal style: no background or border\n  ", "\n\n  // Filled style: solid background and white arrow\n  ", "\n\n  // Outlined style: transparent background with colored border and arrow\n  ", "\n"])), function (_a) {
+    var direction = _a.direction;
+    return direction === 'left' && 'left: 10px; top: 50%; transform: translateY(-50%);';
+}, function (_a) {
+    var direction = _a.direction;
+    return direction === 'right' && 'right: 10px; top: 50%; transform: translateY(-50%);';
+}, function (_a) {
+    var direction = _a.direction;
+    return direction === 'up' && 'top: 10px; left: 50%; transform: translateX(-50%);';
+}, function (_a) {
+    var direction = _a.direction;
+    return direction === 'down' && 'bottom: 10px; left: 50%; transform: translateX(-50%);';
+}, function (_a) {
+    var arrowStyle = _a.arrowStyle;
+    return arrowStyle === 'minimal' && "\n    background-color: transparent;\n    border: none;\n  ";
+}, function (_a) {
+    var arrowStyle = _a.arrowStyle, arrowColor = _a.arrowColor;
+    return arrowStyle === 'filled' && "\n    background-color: ".concat(arrowColor === 'white' ? 'white' : 'black', ";\n    color: ").concat(arrowColor === 'white' ? 'black' : 'white', ";\n  ");
+}, function (_a) {
+    var arrowStyle = _a.arrowStyle, arrowColor = _a.arrowColor;
+    return arrowStyle === 'outlined' && "\n    background-color: transparent;\n    border: 2px solid ".concat(arrowColor === 'white' ? 'white' : 'black', ";\n    color: ").concat(arrowColor === 'white' ? 'white' : 'black', ";\n  ");
+});
+var templateObject_1, templateObject_2, templateObject_3, templateObject_4, templateObject_5, templateObject_6;

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { default as Slider } from '../src/components/Slider';

package/dist/index.js

@@ -0,0 +1 @@
+export { default as Slider } from '../src/components/Slider';

package/dist/reportWebVitals.d.ts

@@ -0,0 +1,3 @@
+import { ReportHandler } from 'web-vitals';
+declare const reportWebVitals: (onPerfEntry?: ReportHandler) => void;
+export default reportWebVitals;

package/dist/reportWebVitals.js

@@ -0,0 +1,13 @@
+var reportWebVitals = function (onPerfEntry) {
+    if (onPerfEntry && onPerfEntry instanceof Function) {
+        import('web-vitals').then(function (_a) {
+            var getCLS = _a.getCLS, getFID = _a.getFID, getFCP = _a.getFCP, getLCP = _a.getLCP, getTTFB = _a.getTTFB;
+            getCLS(onPerfEntry);
+            getFID(onPerfEntry);
+            getFCP(onPerfEntry);
+            getLCP(onPerfEntry);
+            getTTFB(onPerfEntry);
+        });
+    }
+};
+export default reportWebVitals;

package/dist/setupTests.d.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom';

package/dist/setupTests.js

@@ -0,0 +1,5 @@
+// jest-dom adds custom jest matchers for asserting on DOM nodes.
+// allows you to do things like:
+// expect(element).toHaveTextContent(/react/i)
+// learn more: https://github.com/testing-library/jest-dom
+import '@testing-library/jest-dom';

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "react-styled-slider-component",
+  "version": "0.1.0",
+  "description": "A customizable React slider component built with react ts and styled-components.",
+  "main": "index.js",
+  "scripts": {
+    "start": "react-scripts start",
+    "build": "react-scripts build",
+    "test": "react-scripts test",
+    "eject": "react-scripts eject",
+    "prepublishOnly": "npm run build && tsc"
+  },
+  "keywords": [
+    "react",
+    "slider",
+    "styled-components",
+    "typescript",
+    "component"
+  ],
+  "author": "Ceyda Ulubas",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ceydaulubas/slider.git"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@testing-library/jest-dom": "^5.17.0",
+    "@testing-library/react": "^13.4.0",
+    "@testing-library/user-event": "^13.5.0",
+    "@types/jest": "^27.5.2",
+    "@types/node": "^16.18.107",
+    "@types/react": "^18.3.5",
+    "@types/react-dom": "^18.3.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-scripts": "5.0.1",
+    "styled-components": "^6.1.13",
+    "typescript": "^4.9.5",
+    "web-vitals": "^2.1.4"
+  },
+  "devDependencies": {
+    "typescript": "^4.9.5"
+  },
+  "eslintConfig": {
+    "extends": [
+      "react-app",
+      "react-app/jest"
+    ]
+  },
+  "browserslist": {
+    "production": [
+      ">0.2%",
+      "not dead",
+      "not op_mini all"
+    ],
+    "development": [
+      "last 1 chrome version",
+      "last 1 firefox version",
+      "last 1 safari version"
+    ]
+  }
+}

package/src/App.test.tsx

@@ -0,0 +1,9 @@
+import React from 'react';
+import { render, screen } from '@testing-library/react';
+import App from './App';
+
+test('renders learn react link', () => {
+  render(<App />);
+  const linkElement = screen.getByText(/learn react/i);
+  expect(linkElement).toBeInTheDocument();
+});

package/src/App.tsx

@@ -0,0 +1,29 @@
+import React from 'react';
+import Slider from './components/Slider';
+
+const App: React.FC = () => {
+  return (
+    <div>
+      <Slider
+        visibleSlides={2}
+        showDots={true}
+        showArrows={true}
+        dotsPosition="bottom"
+        slideStep={1}
+        direction="horizontal"
+        arrowStyle="minimal" 
+      >
+        <div style={{ backgroundColor: 'red', height: '200px' }}>Slide 1</div>
+        <div style={{ backgroundColor: 'blue', height: '200px' }}>Slide 2</div>
+        <div style={{ backgroundColor: 'green', height: '200px' }}>Slide 3</div>
+        <div style={{ backgroundColor: 'yellow', height: '200px' }}>Slide 4</div>
+        <div style={{ backgroundColor: 'red', height: '200px' }}>Slide 5</div>
+        <div style={{ backgroundColor: 'blue', height: '200px' }}>Slide 6</div>
+        <div style={{ backgroundColor: 'green', height: '200px' }}>Slide 7</div>
+        <div style={{ backgroundColor: 'yellow', height: '200px' }}>Slide 8</div>
+      </Slider>
+    </div>
+  );
+};
+
+export default App;

package/src/components/Slider.tsx

@@ -0,0 +1,139 @@
+import React, { useState } from "react";
+import {
+  SliderWrapper,
+  SlideTrack,
+  Slide,
+  DotsWrapper,
+  Dot,
+  Arrow,
+} from "./SliderStyles.styles";
+
+interface SliderProps {
+  children: React.ReactNode[];
+  visibleSlides?: number;
+  showDots?: boolean;
+  showArrows?: boolean;
+  dotsPosition?: "top" | "bottom" | "left" | "right";
+  slideStep?: number;
+  direction?: "horizontal" | "vertical";
+  arrowStyle?: "minimal" | "filled" | "outlined";
+  arrowColor?: "black" | "white";
+}
+
+const Slider: React.FC<SliderProps> = ({
+  children,
+  visibleSlides = 1,
+  showDots = true,
+  showArrows = true,
+  dotsPosition = "bottom",
+  slideStep = 1,
+  direction = "horizontal",
+  arrowStyle = "minimal",
+  arrowColor = "black",
+}) => {
+  const [currentIndex, setCurrentIndex] = useState(0);
+
+  const totalSlides = children.length;
+
+  // Maximum index value, preventing overflow when navigating through slides.
+  const maxIndex = totalSlides - visibleSlides;
+
+  // Calculate the number of dots based on the total number of slides and the number of visible slides.
+  const numberOfDots = Math.ceil((totalSlides - visibleSlides + 1) / slideStep);
+
+  const isHorizontal = direction === "horizontal";
+
+  const goToNext = () => {
+    setCurrentIndex((prevIndex) => Math.min(prevIndex + slideStep, maxIndex));
+  };
+
+  const goToPrev = () => {
+    setCurrentIndex((prevIndex) => Math.max(prevIndex - slideStep, 0));
+  };
+
+  const goToSlide = (index: number) => {
+    setCurrentIndex(index);
+  };
+
+  const slidePercentage = isHorizontal
+    ? 100 / visibleSlides
+    : 100 / totalSlides; 
+
+  return (
+    <SliderWrapper
+      direction={direction} 
+      style={{
+        height: isHorizontal ? "auto" : `${visibleSlides * 200}px`, 
+        display: isHorizontal ? "block" : "flex",
+        flexDirection: isHorizontal ? "row" : "column",
+      }}
+    >
+      {showArrows && (
+        <Arrow
+          direction={isHorizontal ? "left" : "up"}
+          arrowStyle={arrowStyle}
+          arrowColor={arrowColor}
+          onClick={goToPrev}
+        >
+          {isHorizontal ? "<" : "˄"}
+        </Arrow>
+      )}
+
+      <SlideTrack
+        style={{
+          transform: isHorizontal
+            ? `translateX(-${currentIndex * slidePercentage}%)`
+            : `translateY(-${(currentIndex * slideStep * 100) / totalSlides}%)`,
+          display: "flex",
+          flexDirection: isHorizontal ? "row" : "column",
+          width: isHorizontal ? "100%" : "100%",
+          height: isHorizontal ? "auto" : `${totalSlides * 100}%`,
+          transition: "transform 0.3s ease-in-out",
+          boxSizing: "border-box",
+        }}
+      >
+        {children.map((child, index) => (
+          <Slide
+            key={index}
+            visibleSlides={visibleSlides}
+            style={{
+              flex: isHorizontal ? `0 0 ${slidePercentage}%` : "1", // Remove flex-basis for vertical slides
+              width: isHorizontal ? `${slidePercentage}%` : "100%",
+              height: isHorizontal ? "auto" : `${100 / totalSlides}%`,
+              boxSizing: "border-box",
+              margin: "0",
+              padding: "0",
+            }}
+          >
+            {child}
+          </Slide>
+        ))}
+      </SlideTrack>
+
+      {showArrows && (
+        <Arrow
+          direction={isHorizontal ? "right" : "down"}
+          arrowStyle={arrowStyle}
+          arrowColor={arrowColor}
+          onClick={goToNext}
+        >
+          {isHorizontal ? ">" : "˅"}
+        </Arrow>
+      )}
+
+      {showDots && (
+        <DotsWrapper position={dotsPosition}>
+          {Array.from({ length: numberOfDots }).map((_, index) => (
+            <Dot
+              key={index}
+              active={index * slideStep === currentIndex}
+              onClick={() => goToSlide(index * slideStep)}
+            />
+          ))}
+        </DotsWrapper>
+      )}
+    </SliderWrapper>
+  );
+};
+
+export default Slider;

package/src/components/SliderStyles.styles.ts

@@ -0,0 +1,89 @@
+import styled from 'styled-components';
+
+export const SliderWrapper = styled.div<{ direction: 'horizontal' | 'vertical' }>`
+  position: relative;
+  width: 100%;
+  overflow: hidden;
+  height: ${({ direction }) => (direction === 'vertical' ? '100%' : 'auto')}; // Ensure full height for vertical sliders
+
+  ${({ direction }) => direction === 'vertical' && `
+    display: flex;
+    flex-direction: column;
+  `}
+`;
+
+
+export const SlideTrack = styled.div`
+  display: flex;
+  transition: transform 0.3s ease-in-out;
+`;
+
+
+export const Slide = styled.div<{ visibleSlides: number }>`
+  width: 100%;
+  height: 100%;
+  box-sizing: border-box;
+  margin: 0; 
+  padding: 0; 
+`;
+
+
+
+export const DotsWrapper = styled.div<{ position: 'top' | 'bottom' | 'left' | 'right' }>`
+  display: flex;
+  justify-content: center;
+  flex-direction: ${({ position }) => (position === 'left' || position === 'right' ? 'column' : 'row')};
+  margin-top: ${({ position }) => (position === 'top' ? '10px' : '0')};
+  margin-bottom: ${({ position }) => (position === 'bottom' ? '10px' : '0')};
+  margin-left: ${({ position }) => (position === 'left' ? '10px' : '0')};
+  margin-right: ${({ position }) => (position === 'right' ? '10px' : '0')};
+`;
+
+export const Dot = styled.div<{ active: boolean }>`
+  width: 10px;
+  height: 10px;
+  border-radius: 50%;
+  background-color: ${({ active }) => (active ? 'black' : 'lightgray')};
+  margin: 0 5px;
+  cursor: pointer;
+`;
+export const Arrow = styled.div<{ direction: 'left' | 'right' | 'up' | 'down', arrowStyle: 'minimal' | 'filled' | 'outlined', arrowColor: 'black' | 'white' }>`
+  position: absolute;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 40px;
+  height: 40px;
+  border-radius: 50%;
+  font-size: 24px;
+  cursor: pointer;
+  z-index: 1;
+  user-select: none;
+
+  // Horizontal arrows
+  ${({ direction }) => direction === 'left' && 'left: 10px; top: 50%; transform: translateY(-50%);'}
+  ${({ direction }) => direction === 'right' && 'right: 10px; top: 50%; transform: translateY(-50%);'}
+
+  // Vertical arrows
+  ${({ direction }) => direction === 'up' && 'top: 10px; left: 50%; transform: translateX(-50%);'}
+  ${({ direction }) => direction === 'down' && 'bottom: 10px; left: 50%; transform: translateX(-50%);'}
+
+  // Minimal style: no background or border
+  ${({ arrowStyle }) => arrowStyle === 'minimal' && `
+    background-color: transparent;
+    border: none;
+  `}
+
+  // Filled style: solid background and white arrow
+  ${({ arrowStyle, arrowColor }) => arrowStyle === 'filled' && `
+    background-color: ${arrowColor === 'white' ? 'white' : 'black'};
+    color: ${arrowColor === 'white' ? 'black' : 'white'};
+  `}
+
+  // Outlined style: transparent background with colored border and arrow
+  ${({ arrowStyle, arrowColor }) => arrowStyle === 'outlined' && `
+    background-color: transparent;
+    border: 2px solid ${arrowColor === 'white' ? 'white' : 'black'};
+    color: ${arrowColor === 'white' ? 'white' : 'black'};
+  `}
+`;

package/src/index.css

@@ -0,0 +1,13 @@
+body {
+  margin: 0;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
+    'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',
+    sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+code {
+  font-family: source-code-pro, Menlo, Monaco, Consolas, 'Courier New',
+    monospace;
+}

package/src/index.tsx

@@ -0,0 +1 @@
+export { default as Slider } from '../src/components/Slider';

package/src/logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 841.9 595.3"><g fill="#61DAFB"><path d="M666.3 296.5c0-32.5-40.7-63.3-103.1-82.4 14.4-63.6 8-114.2-20.2-130.4-6.5-3.8-14.1-5.6-22.4-5.6v22.3c4.6 0 8.3.9 11.4 2.6 13.6 7.8 19.5 37.5 14.9 75.7-1.1 9.4-2.9 19.3-5.1 29.4-19.6-4.8-41-8.5-63.5-10.9-13.5-18.5-27.5-35.3-41.6-50 32.6-30.3 63.2-46.9 84-46.9V78c-27.5 0-63.5 19.6-99.9 53.6-36.4-33.8-72.4-53.2-99.9-53.2v22.3c20.7 0 51.4 16.5 84 46.6-14 14.7-28 31.4-41.3 49.9-22.6 2.4-44 6.1-63.6 11-2.3-10-4-19.7-5.2-29-4.7-38.2 1.1-67.9 14.6-75.8 3-1.8 6.9-2.6 11.5-2.6V78.5c-8.4 0-16 1.8-22.6 5.6-28.1 16.2-34.4 66.7-19.9 130.1-62.2 19.2-102.7 49.9-102.7 82.3 0 32.5 40.7 63.3 103.1 82.4-14.4 63.6-8 114.2 20.2 130.4 6.5 3.8 14.1 5.6 22.5 5.6 27.5 0 63.5-19.6 99.9-53.6 36.4 33.8 72.4 53.2 99.9 53.2 8.4 0 16-1.8 22.6-5.6 28.1-16.2 34.4-66.7 19.9-130.1 62-19.1 102.5-49.9 102.5-82.3zm-130.2-66.7c-3.7 12.9-8.3 26.2-13.5 39.5-4.1-8-8.4-16-13.1-24-4.6-8-9.5-15.8-14.4-23.4 14.2 2.1 27.9 4.7 41 7.9zm-45.8 106.5c-7.8 13.5-15.8 26.3-24.1 38.2-14.9 1.3-30 2-45.2 2-15.1 0-30.2-.7-45-1.9-8.3-11.9-16.4-24.6-24.2-38-7.6-13.1-14.5-26.4-20.8-39.8 6.2-13.4 13.2-26.8 20.7-39.9 7.8-13.5 15.8-26.3 24.1-38.2 14.9-1.3 30-2 45.2-2 15.1 0 30.2.7 45 1.9 8.3 11.9 16.4 24.6 24.2 38 7.6 13.1 14.5 26.4 20.8 39.8-6.3 13.4-13.2 26.8-20.7 39.9zm32.3-13c5.4 13.4 10 26.8 13.8 39.8-13.1 3.2-26.9 5.9-41.2 8 4.9-7.7 9.8-15.6 14.4-23.7 4.6-8 8.9-16.1 13-24.1zM421.2 430c-9.3-9.6-18.6-20.3-27.8-32 9 .4 18.2.7 27.5.7 9.4 0 18.7-.2 27.8-.7-9 11.7-18.3 22.4-27.5 32zm-74.4-58.9c-14.2-2.1-27.9-4.7-41-7.9 3.7-12.9 8.3-26.2 13.5-39.5 4.1 8 8.4 16 13.1 24 4.7 8 9.5 15.8 14.4 23.4zM420.7 163c9.3 9.6 18.6 20.3 27.8 32-9-.4-18.2-.7-27.5-.7-9.4 0-18.7.2-27.8.7 9-11.7 18.3-22.4 27.5-32zm-74 58.9c-4.9 7.7-9.8 15.6-14.4 23.7-4.6 8-8.9 16-13 24-5.4-13.4-10-26.8-13.8-39.8 13.1-3.1 26.9-5.8 41.2-7.9zm-90.5 125.2c-35.4-15.1-58.3-34.9-58.3-50.6 0-15.7 22.9-35.6 58.3-50.6 8.6-3.7 18-7 27.7-10.1 5.7 19.6 13.2 40 22.5 60.9-9.2 20.8-16.6 41.1-22.2 60.6-9.9-3.1-19.3-6.5-28-10.2zM310 490c-13.6-7.8-19.5-37.5-14.9-75.7 1.1-9.4 2.9-19.3 5.1-29.4 19.6 4.8 41 8.5 63.5 10.9 13.5 18.5 27.5 35.3 41.6 50-32.6 30.3-63.2 46.9-84 46.9-4.5-.1-8.3-1-11.3-2.7zm237.2-76.2c4.7 38.2-1.1 67.9-14.6 75.8-3 1.8-6.9 2.6-11.5 2.6-20.7 0-51.4-16.5-84-46.6 14-14.7 28-31.4 41.3-49.9 22.6-2.4 44-6.1 63.6-11 2.3 10.1 4.1 19.8 5.2 29.1zm38.5-66.7c-8.6 3.7-18 7-27.7 10.1-5.7-19.6-13.2-40-22.5-60.9 9.2-20.8 16.6-41.1 22.2-60.6 9.9 3.1 19.3 6.5 28.1 10.2 35.4 15.1 58.3 34.9 58.3 50.6-.1 15.7-23 35.6-58.4 50.6zM320.8 78.4z"/><circle cx="420.9" cy="296.5" r="45.7"/><path d="M520.5 78.1z"/></g></svg>

package/src/react-app-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="react-scripts" />

package/src/reportWebVitals.ts

@@ -0,0 +1,15 @@
+import { ReportHandler } from 'web-vitals';
+
+const reportWebVitals = (onPerfEntry?: ReportHandler) => {
+  if (onPerfEntry && onPerfEntry instanceof Function) {
+    import('web-vitals').then(({ getCLS, getFID, getFCP, getLCP, getTTFB }) => {
+      getCLS(onPerfEntry);
+      getFID(onPerfEntry);
+      getFCP(onPerfEntry);
+      getLCP(onPerfEntry);
+      getTTFB(onPerfEntry);
+    });
+  }
+};
+
+export default reportWebVitals;

package/src/setupTests.ts

@@ -0,0 +1,5 @@
+// jest-dom adds custom jest matchers for asserting on DOM nodes.
+// allows you to do things like:
+// expect(element).toHaveTextContent(/react/i)
+// learn more: https://github.com/testing-library/jest-dom
+import '@testing-library/jest-dom';