scroll-slides 0.2.0 → 0.3.0

package/README.md

@@ -1,11 +1,367 @@
 # scroll-slides
 
-## Install
+English | [简体中文](./README_zh.md)
+
+A smooth and customizable scroll-based slide animation component for Vue 3. Create engaging scroll experiences with dynamic scaling, translation, and occlusion effects.
+
+![npm version](https://img.shields.io/npm/v/scroll-slides.svg)
+![license](https://img.shields.io/npm/l/scroll-slides.svg)
+
+## ✨ Features
+
+- 🎯 **Smooth Scroll Animations** - Transform items as they scroll with elegant scaling and translation effects
+- 📱 **Direction Support** - Both vertical and horizontal scrolling modes
+- 🎨 **Highly Customizable** - Fine-tune animation parameters to match your design
+- 🔄 **Dynamic Item Management** - Add or remove items on the fly
+- 📐 **Flexible Templates** - Use generic or per-item slot templates
+- 🚀 **Performance Optimized** - Efficient event handling and DOM updates
+- 💅 **TypeScript Support** - Full type definitions included
+- 🎭 **Occlusion Effects** - Optional lower item clipping for depth perception
+
+## 📦 Installation
 
 ```bash
 npm install scroll-slides
+```
 
+```bash
 yarn add scroll-slides
+```
 
+```bash
 pnpm add scroll-slides
 ```
+
+## 🚀 Quick Start
+
+### Basic Usage
+
+```vue
+<script setup>
+import { ScrollSlide } from 'scroll-slides';
+</script>
+
+<template>
+  <ScrollSlide
+    direction="vertical"
+    :item-count="10"
+    style="height: 600px; overflow-y: auto;"
+  >
+    <template #item="{ index }">
+      <div class="slide-item">
+        Slide {{ index + 1 }}
+      </div>
+    </template>
+  </ScrollSlide>
+</template>
+
+<style scoped>
+.slide-item {
+  width: 100%;
+  height: 100px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  border-radius: 15px;
+  color: white;
+  margin-bottom: 10px;
+}
+</style>
+```
+
+### Horizontal Scrolling
+
+```vue
+<template>
+  <ScrollSlide
+    direction="horizontal"
+    :item-count="15"
+    :scale-start-percent="0.95"
+    :translate-factor="50"
+    :spacer-enabled="true"
+    style="width: 100%; height: 200px; overflow-x: auto;"
+  >
+    <template #item="{ index }">
+      <div class="horizontal-item">
+        Item {{ index + 1 }}
+      </div>
+    </template>
+  </ScrollSlide>
+</template>
+
+<style scoped>
+.horizontal-item {
+  width: 200px;
+  height: 120px;
+  margin-right: 15px;
+  background: #4CAF50;
+  border-radius: 10px;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  color: white;
+}
+</style>
+```
+
+### Independent Templates
+
+You can define unique content for each item using indexed slots:
+
+```vue
+<template>
+  <ScrollSlide direction="vertical" :item-count="3">
+    <template #item-0>
+      <div class="custom-item">🌸 First Item</div>
+    </template>
+    
+    <template #item-1>
+      <div class="custom-item">🎨 Second Item</div>
+    </template>
+    
+    <template #item-2>
+      <div class="custom-item">🚀 Third Item</div>
+    </template>
+  </ScrollSlide>
+</template>
+```
+
+## 📖 API Reference
+
+### Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `direction` | `'vertical' \| 'horizontal'` | `'vertical'` | Scrolling direction |
+| `itemCount` | `number` | `0` | Total number of items in the list |
+| `scaleRatio` | `number` | `0.7` | Final scale of the item when it slides out (0-1) |
+| `scaleStartPercent` | `number` | `0.8` | Threshold percentage for scaling to start (0-1) |
+| `translateFactor` | `number` | `100` | Adjusts the displacement offset during slide-out |
+| `spacerEnabled` | `boolean` | `false` | Adds a spacer at start to allow first item to scroll out |
+| `occludeLowerItems` | `boolean` | `false` | Applies clip-path to prevent visual overlap |
+
+### Slots
+
+#### Default Item Slot
+
+Used when no specific item slot is defined:
+
+```vue
+<template #item="{ index }">
+  <!-- Your content here -->
+  <!-- index: number - The zero-based index of the current item -->
+</template>
+```
+
+#### Indexed Item Slots
+
+Define unique content for specific items:
+
+```vue
+<template #item-0>
+  <!-- Content for first item -->
+</template>
+
+<template #item-1>
+  <!-- Content for second item -->
+</template>
+```
+
+**Note:** Indexed slots take priority over the generic `#item` slot.
+
+#### Spacer Slot
+
+Customize the spacer element (when `spacerEnabled` is `true`):
+
+```vue
+<template #spacer="{ size }">
+  <!-- size: number - The calculated size of the spacer in pixels -->
+  <div>Custom Spacer Content</div>
+</template>
+```
+
+## 🎨 Customization Examples
+
+### Subtle Animation
+
+```vue
+<ScrollSlide
+  :scale-ratio="0.9"
+  :scale-start-percent="0.95"
+  :translate-factor="20"
+  :item-count="10"
+>
+  <template #item="{ index }">
+    <!-- Your content -->
+  </template>
+</ScrollSlide>
+```
+
+### Dramatic Effect
+
+```vue
+<ScrollSlide
+  :scale-ratio="0.5"
+  :scale-start-percent="0.7"
+  :translate-factor="150"
+  :occlude-lower-items="true"
+  :item-count="10"
+>
+  <template #item="{ index }">
+    <!-- Your content -->
+  </template>
+</ScrollSlide>
+```
+
+### Horizontal Card Carousel
+
+```vue
+<ScrollSlide
+  direction="horizontal"
+  :item-count="20"
+  :scale-ratio="0.85"
+  :scale-start-percent="0.9"
+  :translate-factor="30"
+  :spacer-enabled="true"
+  style="width: 100%; height: 250px; overflow-x: auto;"
+>
+  <template #item="{ index }">
+    <div class="card">
+      Card {{ index + 1 }}
+    </div>
+  </template>
+</ScrollSlide>
+```
+
+## 🔧 Advanced Usage
+
+### Dynamic Item Count
+
+```vue
+<script setup>
+import { ref } from 'vue';
+import { ScrollSlide } from 'scroll-slides';
+
+const items = ref([1, 2, 3, 4, 5]);
+
+const addItem = () => {
+  items.value.push(items.value.length + 1);
+};
+
+const removeItem = () => {
+  items.value.pop();
+};
+</script>
+
+<template>
+  <div>
+    <button @click="addItem">Add Item</button>
+    <button @click="removeItem">Remove Item</button>
+    
+    <ScrollSlide :item-count="items.length">
+      <template #item="{ index }">
+        <div>Item {{ items[index] }}</div>
+      </template>
+    </ScrollSlide>
+  </div>
+</template>
+```
+
+### Responsive Configuration
+
+```vue
+<script setup>
+import { ref, computed, onMounted, onUnmounted } from 'vue';
+import { ScrollSlide } from 'scroll-slides';
+
+const windowWidth = ref(window.innerWidth);
+
+const direction = computed(() => 
+  windowWidth.value < 768 ? 'vertical' : 'horizontal'
+);
+
+const updateWidth = () => {
+  windowWidth.value = window.innerWidth;
+};
+
+onMounted(() => window.addEventListener('resize', updateWidth));
+onUnmounted(() => window.removeEventListener('resize', updateWidth));
+</script>
+
+<template>
+  <ScrollSlide
+    :direction="direction"
+    :item-count="10"
+    :style="direction === 'vertical' 
+      ? 'height: 500px; overflow-y: auto;' 
+      : 'width: 100%; overflow-x: auto;'"
+  >
+    <template #item="{ index }">
+      <!-- Responsive content -->
+    </template>
+  </ScrollSlide>
+</template>
+```
+
+## 💡 Tips & Best Practices
+
+1. **Container Styling**: Always set explicit dimensions and overflow properties on the ScrollSlide container:
+   ```vue
+   <ScrollSlide style="height: 600px; overflow-y: auto;">
+   ```
+
+2. **Item Spacing**: Add margins to your item content, not the slot wrapper:
+   ```css
+   .my-item {
+     margin-bottom: 10px; /* for vertical */
+     margin-right: 10px;  /* for horizontal */
+   }
+   ```
+
+3. **Performance**: For large lists, consider using virtual scrolling techniques in combination with scroll-slides.
+
+4. **Z-Index**: Items are automatically z-indexed in reverse order (first item on top). Plan your designs accordingly.
+
+5. **Spacer Usage**: Enable `spacerEnabled` when you want the first item to be able to scroll to the center/top of the viewport.
+
+## 🛠️ Development
+
+```bash
+# Clone the repository
+git clone https://github.com/agoudbg/scroll-slides.git
+
+# Install dependencies
+pnpm install
+
+# Run development server
+pnpm dev
+
+# Build library
+pnpm build
+
+# Build demo
+pnpm build:demo
+```
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome! Feel free to check the [issues page](https://github.com/agoudbg/scroll-slides/issues).
+
+## 👤 Author
+
+**agoudbg**
+- GitHub: [@agoudbg](https://github.com/agoudbg)
+- Email: agoudbg@gmail.com
+
+## 🌟 Show Your Support
+
+Give a ⭐️ if this project helped you!
+
+---
+
+Made with ❤️ using Vue 3 and TypeScript

package/dist/components/ScrollSlide.vue.d.ts

@@ -1,17 +1,3 @@
-declare const spacerEnabled: import("vue").Ref<boolean, boolean>;
-declare const sliderRef: import("vue").Ref<HTMLElement | null, HTMLElement | null>;
-declare const itemStates: {
-    [key: number]: {
-        scale: number;
-        translate: number;
-        opacity: number;
-    };
-};
-declare const isVertical: import("vue").ComputedRef<boolean>;
-declare const transformProperty: import("vue").ComputedRef<"translateY" | "translateX">;
-declare const itemIndices: import("vue").ComputedRef<number[]>;
-declare const spacerSize: import("vue").Ref<number, number>;
-declare const __VLS_ctx: InstanceType<__VLS_PickNotAny<typeof __VLS_self, new () => {}>>;
 declare var __VLS_1: {
     size: number;
 }, __VLS_4: `item-${number}`, __VLS_5: {
@@ -19,130 +5,138 @@ declare var __VLS_1: {
 }, __VLS_7: {
     index: number;
 };
-type __VLS_Slots = __VLS_PrettifyGlobal<__VLS_OmitStringIndex<typeof __VLS_ctx.$slots> & {
+type __VLS_Slots = {} & {
     [K in NonNullable<typeof __VLS_4>]?: (props: typeof __VLS_5) => any;
 } & {
     spacer?: (props: typeof __VLS_1) => any;
 } & {
     item?: (props: typeof __VLS_7) => any;
-}>;
-declare const __VLS_self: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+};
+declare const __VLS_component: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /**
+     * Scrolling direction
+     * @default 'vertical'
+     * @values 'vertical', 'horizontal'
+     */
     direction: {
         type: StringConstructor;
         default: string;
         validator: (value: string) => boolean;
     };
+    /**
+     * Total number of items in the list
+     * @default 0
+     */
     itemCount: {
         type: NumberConstructor;
         default: number;
     };
+    /**
+     * Scaling ratio
+     * The final scale of the item when it slides out
+     * @default 0.7
+     */
     scaleRatio: {
         type: NumberConstructor;
         default: number;
     };
+    /**
+     * Threshold percentage for scaling to start
+     * Range 0-1, defines where in the viewport the scaling animation begins
+     * @default 0.8
+     */
     scaleStartPercent: {
         type: NumberConstructor;
         default: number;
     };
+    /**
+     * Translation factor
+     * Adjusts the displacement offset during the slide-out effect
+     * @default 100
+     */
     translateFactor: {
         type: NumberConstructor;
         default: number;
     };
+    /**
+     * Whether to enable the spacer element
+     * If true, adds a spacer at the start to allow the first item to scroll out of view
+     * @default false
+     */
     spacerEnabled: {
         type: BooleanConstructor;
         default: boolean;
     };
-}>, {
-    spacerEnabled: typeof spacerEnabled;
-    sliderRef: typeof sliderRef;
-    itemStates: typeof itemStates;
-    isVertical: typeof isVertical;
-    transformProperty: typeof transformProperty;
-    itemIndices: typeof itemIndices;
-    spacerSize: typeof spacerSize;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    direction: {
-        type: StringConstructor;
-        default: string;
-        validator: (value: string) => boolean;
-    };
-    itemCount: {
-        type: NumberConstructor;
-        default: number;
-    };
-    scaleRatio: {
-        type: NumberConstructor;
-        default: number;
-    };
-    scaleStartPercent: {
-        type: NumberConstructor;
-        default: number;
-    };
-    translateFactor: {
-        type: NumberConstructor;
-        default: number;
-    };
-    spacerEnabled: {
+    /**
+     * Whether to occlude lower items
+     * If true, applies a clip-path to prevent visual overlap between scaled items
+     * @default false
+     */
+    occludeLowerItems: {
         type: BooleanConstructor;
         default: boolean;
     };
-}>> & Readonly<{}>, {
-    direction: string;
-    itemCount: number;
-    scaleRatio: number;
-    scaleStartPercent: number;
-    translateFactor: number;
-    spacerEnabled: boolean;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const __VLS_component: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /**
+     * Scrolling direction
+     * @default 'vertical'
+     * @values 'vertical', 'horizontal'
+     */
     direction: {
         type: StringConstructor;
         default: string;
         validator: (value: string) => boolean;
     };
+    /**
+     * Total number of items in the list
+     * @default 0
+     */
     itemCount: {
         type: NumberConstructor;
         default: number;
     };
+    /**
+     * Scaling ratio
+     * The final scale of the item when it slides out
+     * @default 0.7
+     */
     scaleRatio: {
         type: NumberConstructor;
         default: number;
     };
+    /**
+     * Threshold percentage for scaling to start
+     * Range 0-1, defines where in the viewport the scaling animation begins
+     * @default 0.8
+     */
     scaleStartPercent: {
         type: NumberConstructor;
         default: number;
     };
+    /**
+     * Translation factor
+     * Adjusts the displacement offset during the slide-out effect
+     * @default 100
+     */
     translateFactor: {
         type: NumberConstructor;
         default: number;
     };
+    /**
+     * Whether to enable the spacer element
+     * If true, adds a spacer at the start to allow the first item to scroll out of view
+     * @default false
+     */
     spacerEnabled: {
         type: BooleanConstructor;
         default: boolean;
     };
-}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    direction: {
-        type: StringConstructor;
-        default: string;
-        validator: (value: string) => boolean;
-    };
-    itemCount: {
-        type: NumberConstructor;
-        default: number;
-    };
-    scaleRatio: {
-        type: NumberConstructor;
-        default: number;
-    };
-    scaleStartPercent: {
-        type: NumberConstructor;
-        default: number;
-    };
-    translateFactor: {
-        type: NumberConstructor;
-        default: number;
-    };
-    spacerEnabled: {
+    /**
+     * Whether to occlude lower items
+     * If true, applies a clip-path to prevent visual overlap between scaled items
+     * @default false
+     */
+    occludeLowerItems: {
         type: BooleanConstructor;
         default: boolean;
     };
@@ -153,6 +147,7 @@ declare const __VLS_component: import("vue").DefineComponent<import("vue").Extra
     scaleStartPercent: number;
     translateFactor: number;
     spacerEnabled: boolean;
+    occludeLowerItems: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
 export default _default;

package/dist/scroll-slides.css

@@ -1 +1 @@
-.slider[data-v-2ecb83b3]{position:relative;width:100%;height:100%;overflow-y:auto;overflow-x:hidden;box-sizing:border-box}.slider.horizontal[data-v-2ecb83b3]{display:flex;align-items:center;overflow-x:auto;overflow-y:hidden;white-space:nowrap}.slider-item[data-v-2ecb83b3]{position:relative}.slider-item .slider-slot[data-v-2ecb83b3]{position:relative;transition:transform .04s}.horizontal .slider-item[data-v-2ecb83b3]{display:inline-block;vertical-align:middle;transform-origin:center right}.slider-spacer[data-v-2ecb83b3]{width:100%;height:100%;pointer-events:none}
+.slider[data-v-30dc45e5]{position:relative;width:100%;height:100%;overflow-y:auto;overflow-x:hidden;box-sizing:border-box}.slider.horizontal[data-v-30dc45e5]{display:flex;align-items:center;overflow-x:auto;overflow-y:hidden;white-space:nowrap}.slider-item[data-v-30dc45e5]{position:relative}.slider-item .slider-slot[data-v-30dc45e5]{position:relative;transition:transform .04s}.horizontal .slider-item[data-v-30dc45e5]{display:inline-block;vertical-align:middle;transform-origin:center right}.slider-spacer[data-v-30dc45e5]{width:100%;height:100%;pointer-events:none}

package/dist/scroll-slides.js

@@ -1,62 +1,115 @@
-import { defineComponent as U, toRefs as j, ref as _, reactive as q, computed as b, watch as L, onMounted as X, onUnmounted as Y, nextTick as D, createElementBlock as h, openBlock as y, normalizeClass as G, createCommentVNode as J, unref as K, normalizeStyle as P, renderSlot as R, Fragment as Q, renderList as Z, createElementVNode as ee } from "vue";
-const te = /* @__PURE__ */ U({
+import { defineComponent as te, toRefs as ae, ref as $, reactive as le, computed as I, watch as W, onMounted as oe, nextTick as x, onUnmounted as se, createElementBlock as S, openBlock as P, normalizeClass as ne, createCommentVNode as re, unref as ce, normalizeStyle as L, renderSlot as b, Fragment as ie, renderList as ue, createElementVNode as ve } from "vue";
+const de = /* @__PURE__ */ te({
   __name: "ScrollSlide",
   props: {
+    /**
+     * Scrolling direction
+     * @default 'vertical'
+     * @values 'vertical', 'horizontal'
+     */
     direction: {
       type: String,
       default: "vertical",
       // 'vertical' or 'horizontal'
-      validator: (c) => ["vertical", "horizontal"].includes(c)
+      validator: (u) => ["vertical", "horizontal"].includes(u)
     },
+    /**
+     * Total number of items in the list
+     * @default 0
+     */
     itemCount: {
       type: Number,
       default: 0
     },
+    /**
+     * Scaling ratio
+     * The final scale of the item when it slides out
+     * @default 0.7
+     */
     scaleRatio: {
       type: Number,
       default: 0.7
     },
+    /**
+     * Threshold percentage for scaling to start
+     * Range 0-1, defines where in the viewport the scaling animation begins
+     * @default 0.8
+     */
     scaleStartPercent: {
       type: Number,
       default: 0.8
     },
+    /**
+     * Translation factor
+     * Adjusts the displacement offset during the slide-out effect
+     * @default 100
+     */
     translateFactor: {
       type: Number,
       default: 100
     },
+    /**
+     * Whether to enable the spacer element
+     * If true, adds a spacer at the start to allow the first item to scroll out of view
+     * @default false
+     */
     spacerEnabled: {
       type: Boolean,
       default: !1
+    },
+    /**
+     * Whether to occlude lower items
+     * If true, applies a clip-path to prevent visual overlap between scaled items
+     * @default false
+     */
+    occludeLowerItems: {
+      type: Boolean,
+      default: !1
     }
   },
-  setup(c) {
-    const n = c, {
-      direction: m,
-      itemCount: g,
-      scaleRatio: S,
-      scaleStartPercent: N,
-      translateFactor: B,
-      spacerEnabled: w
-    } = j(n), a = _(null), d = _([]), r = q({}), o = b(() => n.direction === "vertical"), I = b(() => o.value ? "translateY" : "translateX"), F = (e, t) => Math.min(Math.max(e / t, 0), 1), x = (e) => e * e * (3 - 2 * e), z = b(() => Array.from({ length: n.itemCount }, (e, t) => t)), s = () => {
-      A(), k();
-    }, A = () => {
-      if (!a.value) return;
-      const e = a.value, t = e[o.value ? "clientHeight" : "clientWidth"];
-      d.value.forEach((l, i) => {
-        const v = l.getBoundingClientRect(), f = o.value ? v.top : v.left, M = e.getBoundingClientRect(), H = f - (o.value ? M.top : M.left), T = Math.min(
-          Math.max(0, (t - H) / t),
+  setup(u) {
+    const l = u, {
+      direction: y,
+      itemCount: z,
+      scaleRatio: w,
+      scaleStartPercent: q,
+      translateFactor: U,
+      spacerEnabled: k,
+      occludeLowerItems: j
+    } = ae(l), o = $(null), g = $([]), r = le({});
+    let v = null;
+    const s = I(() => l.direction === "vertical"), X = I(() => s.value ? "translateY" : "translateX"), Y = (e, t) => Math.min(Math.max(e / t, 0), 1), D = (e) => e * e * (3 - 2 * e), E = I(() => Array.from({ length: l.itemCount }, (e, t) => t)), n = () => {
+      G(), B();
+    }, G = () => {
+      if (!o.value) return;
+      const e = o.value, t = e[s.value ? "clientHeight" : "clientWidth"], a = e[s.value ? "scrollTop" : "scrollLeft"];
+      let c = -1 / 0, f = 0;
+      g.value.forEach((i, m) => {
+        const N = i.getBoundingClientRect(), J = s.value ? N.top : N.left, F = e.getBoundingClientRect(), K = J - (s.value ? F.top : F.left), Q = Math.min(
+          Math.max(0, (t - K) / t),
           1
-        ), V = F(1 - T - n.scaleStartPercent, 1 - n.scaleStartPercent), C = x(V), W = 1 + (n.scaleRatio - 1) * C, O = C * n.translateFactor;
-        let p;
-        const E = Math.min(Math.max(C || 0, 0), 1);
-        E > 0.6 ? p = 0 : E < 0.4 ? p = 1 : p = (0.6 - E) / 0.2, r[i] = {
-          scale: W,
-          translate: O,
-          opacity: p
+        ), Z = Y(1 - Q - l.scaleStartPercent, 1 - l.scaleStartPercent), C = D(Z), p = 1 + (l.scaleRatio - 1) * C, T = C * l.translateFactor;
+        let h;
+        const R = Math.min(Math.max(C || 0, 0), 1);
+        R > 0.6 ? h = 0 : R < 0.4 ? h = 1 : h = (0.6 - R) / 0.2;
+        let _;
+        const A = s.value ? i.offsetHeight : i.offsetWidth, H = (s.value ? i.offsetTop : i.offsetLeft) - a + A * (0.5 - T / 100 - p / 2), ee = H + A * p;
+        if (l.occludeLowerItems && m > 0 && f > 0.05) {
+          const O = c - H;
+          if (O > 0.5 && p > 0.01) {
+            const V = O / p;
+            s.value ? _ = `inset(${V}px 0 0 0)` : _ = `inset(0 0 0 ${V}px)`;
+          }
+        }
+        c = ee, f = h, r[m] = {
+          scale: p,
+          translate: T,
+          opacity: h,
+          clipPath: _
         };
       });
-    }, $ = () => {
-      a.value && (d.value = Array.from(a.value.querySelectorAll(".slider-item")), z.value.forEach((e) => {
+    }, M = () => {
+      o.value && (g.value = Array.from(o.value.querySelectorAll(".slider-item")), E.value.forEach((e) => {
         r[e] || (r[e] = {
           scale: 1,
           translate: 0,
@@ -64,84 +117,88 @@ const te = /* @__PURE__ */ U({
         });
       }), Object.keys(r).forEach((e) => {
         const t = Number(e);
-        t >= n.itemCount && delete r[t];
-      }), s());
+        t >= l.itemCount && delete r[t];
+      }), n());
     };
-    L(() => n.itemCount, (e, t) => {
+    W(() => l.itemCount, (e, t) => {
       setTimeout(() => {
-        $();
+        M();
       }, 0);
     }, { immediate: !1 });
-    const u = _(0), k = () => {
-      if (!a.value) return 0;
-      const e = a.value[o.value ? "clientHeight" : "clientWidth"];
+    const d = $(0), B = () => {
+      if (!o.value) return 0;
+      const e = o.value[s.value ? "clientHeight" : "clientWidth"];
       let t = 0;
-      if (d.value.length > 0) {
-        const l = d.value[0];
-        if (l) {
-          const i = l.getBoundingClientRect();
-          t = o.value ? i.height : i.width;
+      if (g.value.length > 0) {
+        const a = g.value[0];
+        if (a) {
+          const c = a.getBoundingClientRect();
+          t = s.value ? c.height : c.width;
         }
       }
-      u.value = Math.max(0, e - t);
+      d.value = Math.max(0, e - t);
     };
-    return k(), X(() => {
-      a.value && (a.value.addEventListener("scroll", s), window.addEventListener("resize", s), a.value.addEventListener("touchmove", s, { passive: !0 }), $());
-    }), Y(() => {
-      a.value && (a.value.removeEventListener("scroll", s), a.value.removeEventListener("touchmove", s)), window.removeEventListener("resize", s);
-    }), L([
-      m,
-      g,
-      S,
-      N,
-      B,
-      w
+    return B(), oe(() => {
+      if (!o.value) return;
+      const e = o.value;
+      v = new ResizeObserver(() => n()), v.observe(e), e.addEventListener("scroll", n), window.addEventListener("resize", n), e.addEventListener("touchmove", n, { passive: !0 }), M(), x(() => requestAnimationFrame(n));
+    }), se(() => {
+      v == null || v.disconnect(), v = null, o.value && (o.value.removeEventListener("scroll", n), o.value.removeEventListener("touchmove", n)), window.removeEventListener("resize", n);
+    }), W([
+      y,
+      z,
+      w,
+      q,
+      U,
+      k,
+      j
     ], () => {
-      console.log("Props changed, reinitializing items"), D(() => {
-        s();
+      console.log("Props changed, reinitializing items"), x(() => {
+        n();
       });
-    }), (e, t) => (y(), h("div", {
-      class: G(["slider", { horizontal: !o.value }]),
+    }), (e, t) => (P(), S("div", {
+      class: ne(["slider", { horizontal: !s.value }]),
       ref_key: "sliderRef",
-      ref: a
+      ref: o
     }, [
-      K(w) ? (y(), h("div", {
+      ce(k) ? (P(), S("div", {
         key: 0,
         class: "slider-spacer",
-        style: P(o.value ? { height: `${u.value}px`, minHeight: `${u.value}px` } : { width: `${u.value}px`, minWidth: `${u.value}px`, display: "inline-block" })
+        style: L(s.value ? { height: `${d.value}px`, minHeight: `${d.value}px` } : { width: `${d.value}px`, minWidth: `${d.value}px`, display: "inline-block" })
       }, [
-        R(e.$slots, "spacer", { size: u.value }, void 0, !0)
-      ], 4)) : J("", !0),
-      (y(!0), h(Q, null, Z(z.value, (l) => {
-        var i, v, f;
-        return y(), h("div", {
-          key: l,
+        b(e.$slots, "spacer", { size: d.value }, void 0, !0)
+      ], 4)) : re("", !0),
+      (P(!0), S(ie, null, ue(E.value, (a) => {
+        var c, f, i, m;
+        return P(), S("div", {
+          key: a,
           class: "slider-item",
-          style: P({
-            zIndex: z.value.length - l
+          style: L({
+            zIndex: E.value.length - a
           })
         }, [
-          ee("div", {
+          ve("div", {
             class: "slider-slot",
-            style: P({
-              transform: `${I.value}(${-((i = r[l]) == null ? void 0 : i.translate) || 0}%) scale(${((v = r[l]) == null ? void 0 : v.scale) || 1})`,
-              opacity: (f = r[l]) == null ? void 0 : f.opacity
+            style: L({
+              transform: `${X.value}(${-((c = r[a]) == null ? void 0 : c.translate) || 0}%) scale(${((f = r[a]) == null ? void 0 : f.scale) || 1})`,
+              opacity: (i = r[a]) == null ? void 0 : i.opacity,
+              clipPath: (m = r[a]) == null ? void 0 : m.clipPath
             })
           }, [
-            R(e.$slots, `item-${l}`, { index: l }, () => [
-              R(e.$slots, "item", { index: l }, void 0, !0)
+            b(e.$slots, `item-${a}`, { index: a }, () => [
+              b(e.$slots, "item", { index: a }, void 0, !0)
             ], !0)
           ], 4)
         ], 4);
       }), 128))
     ], 2));
   }
-}), ae = (c, n) => {
-  const m = c.__vccOpts || c;
-  for (const [g, S] of n)
-    m[g] = S;
-  return m;
-}, ne = /* @__PURE__ */ ae(te, [["__scopeId", "data-v-2ecb83b3"]]);
+}), fe = (u, l) => {
+  const y = u.__vccOpts || u;
+  for (const [z, w] of l)
+    y[z] = w;
+  return y;
+}, ye = /* @__PURE__ */ fe(de, [["__scopeId", "data-v-30dc45e5"]]);
 export {
-  ne as ScrollSlide
+  ye as ScrollSlide
 };

package/dist/scroll-slides.umd.cjs

@@ -1 +1 @@
-(function(c,e){typeof exports=="object"&&typeof module<"u"?e(exports,require("vue")):typeof define=="function"&&define.amd?define(["exports","vue"],e):(c=typeof globalThis<"u"?globalThis:c||self,e(c.ScrollSlide={},c.Vue))})(this,function(c,e){"use strict";const w=((m,o)=>{const p=m.__vccOpts||m;for(const[S,g]of o)p[S]=g;return p})(e.defineComponent({__name:"ScrollSlide",props:{direction:{type:String,default:"vertical",validator:m=>["vertical","horizontal"].includes(m)},itemCount:{type:Number,default:0},scaleRatio:{type:Number,default:.7},scaleStartPercent:{type:Number,default:.8},translateFactor:{type:Number,default:100},spacerEnabled:{type:Boolean,default:!1}},setup(m){const o=m,{direction:p,itemCount:S,scaleRatio:g,scaleStartPercent:B,translateFactor:R,spacerEnabled:k}=e.toRefs(o),l=e.ref(null),h=e.ref([]),r=e.reactive({}),i=e.computed(()=>o.direction==="vertical"),$=e.computed(()=>i.value?"translateY":"translateX"),M=(t,n)=>Math.min(Math.max(t/n,0),1),L=t=>t*t*(3-2*t),z=e.computed(()=>Array.from({length:o.itemCount},(t,n)=>n)),s=()=>{N(),C()},N=()=>{if(!l.value)return;const t=l.value,n=t[i.value?"clientHeight":"clientWidth"];h.value.forEach((a,d)=>{const f=a.getBoundingClientRect(),v=i.value?f.top:f.left,P=t.getBoundingClientRect(),I=v-(i.value?P.top:P.left),T=Math.min(Math.max(0,(n-I)/n),1),x=M(1-T-o.scaleStartPercent,1-o.scaleStartPercent),_=L(x),F=1+(o.scaleRatio-1)*_,V=_*o.translateFactor;let y;const E=Math.min(Math.max(_||0,0),1);E>.6?y=0:E<.4?y=1:y=(.6-E)/.2,r[d]={scale:F,translate:V,opacity:y}})},b=()=>{l.value&&(h.value=Array.from(l.value.querySelectorAll(".slider-item")),z.value.forEach(t=>{r[t]||(r[t]={scale:1,translate:0,opacity:1})}),Object.keys(r).forEach(t=>{const n=Number(t);n>=o.itemCount&&delete r[n]}),s())};e.watch(()=>o.itemCount,(t,n)=>{setTimeout(()=>{b()},0)},{immediate:!1});const u=e.ref(0),C=()=>{if(!l.value)return 0;const t=l.value[i.value?"clientHeight":"clientWidth"];let n=0;if(h.value.length>0){const a=h.value[0];if(a){const d=a.getBoundingClientRect();n=i.value?d.height:d.width}}u.value=Math.max(0,t-n)};return C(),e.onMounted(()=>{l.value&&(l.value.addEventListener("scroll",s),window.addEventListener("resize",s),l.value.addEventListener("touchmove",s,{passive:!0}),b())}),e.onUnmounted(()=>{l.value&&(l.value.removeEventListener("scroll",s),l.value.removeEventListener("touchmove",s)),window.removeEventListener("resize",s)}),e.watch([p,S,g,B,R,k],()=>{console.log("Props changed, reinitializing items"),e.nextTick(()=>{s()})}),(t,n)=>(e.openBlock(),e.createElementBlock("div",{class:e.normalizeClass(["slider",{horizontal:!i.value}]),ref_key:"sliderRef",ref:l},[e.unref(k)?(e.openBlock(),e.createElementBlock("div",{key:0,class:"slider-spacer",style:e.normalizeStyle(i.value?{height:`${u.value}px`,minHeight:`${u.value}px`}:{width:`${u.value}px`,minWidth:`${u.value}px`,display:"inline-block"})},[e.renderSlot(t.$slots,"spacer",{size:u.value},void 0,!0)],4)):e.createCommentVNode("",!0),(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(z.value,a=>{var d,f,v;return e.openBlock(),e.createElementBlock("div",{key:a,class:"slider-item",style:e.normalizeStyle({zIndex:z.value.length-a})},[e.createElementVNode("div",{class:"slider-slot",style:e.normalizeStyle({transform:`${$.value}(${-((d=r[a])==null?void 0:d.translate)||0}%) scale(${((f=r[a])==null?void 0:f.scale)||1})`,opacity:(v=r[a])==null?void 0:v.opacity})},[e.renderSlot(t.$slots,`item-${a}`,{index:a},()=>[e.renderSlot(t.$slots,"item",{index:a},void 0,!0)],!0)],4)],4)}),128))],2))}}),[["__scopeId","data-v-2ecb83b3"]]);c.ScrollSlide=w,Object.defineProperty(c,Symbol.toStringTag,{value:"Module"})});
+(function(f,e){typeof exports=="object"&&typeof module<"u"?e(exports,require("vue")):typeof define=="function"&&define.amd?define(["exports","vue"],e):(f=typeof globalThis<"u"?globalThis:f||self,e(f.ScrollSlide={},f.Vue))})(this,(function(f,e){"use strict";const F=((u,n)=>{const g=u.__vccOpts||u;for(const[z,E]of n)g[z]=E;return g})(e.defineComponent({__name:"ScrollSlide",props:{direction:{type:String,default:"vertical",validator:u=>["vertical","horizontal"].includes(u)},itemCount:{type:Number,default:0},scaleRatio:{type:Number,default:.7},scaleStartPercent:{type:Number,default:.8},translateFactor:{type:Number,default:100},spacerEnabled:{type:Boolean,default:!1},occludeLowerItems:{type:Boolean,default:!1}},setup(u){const n=u,{direction:g,itemCount:z,scaleRatio:E,scaleStartPercent:O,translateFactor:V,spacerEnabled:B,occludeLowerItems:A}=e.toRefs(n),a=e.ref(null),P=e.ref([]),c=e.reactive({});let m=null;const s=e.computed(()=>n.direction==="vertical"),H=e.computed(()=>s.value?"translateY":"translateX"),W=(t,l)=>Math.min(Math.max(t/l,0),1),j=t=>t*t*(3-2*t),_=e.computed(()=>Array.from({length:n.itemCount},(t,l)=>l)),r=()=>{q(),R()},q=()=>{if(!a.value)return;const t=a.value,l=t[s.value?"clientHeight":"clientWidth"],o=t[s.value?"scrollTop":"scrollLeft"];let i=-1/0,h=0;P.value.forEach((d,v)=>{const $=d.getBoundingClientRect(),U=s.value?$.top:$.left,I=t.getBoundingClientRect(),X=U-(s.value?I.top:I.left),Y=Math.min(Math.max(0,(l-X)/l),1),D=W(1-Y-n.scaleStartPercent,1-n.scaleStartPercent),k=j(D),y=1+(n.scaleRatio-1)*k,L=k*n.translateFactor;let S;const w=Math.min(Math.max(k||0,0),1);w>.6?S=0:w<.4?S=1:S=(.6-w)/.2;let b;const M=s.value?d.offsetHeight:d.offsetWidth,T=(s.value?d.offsetTop:d.offsetLeft)-o+M*(.5-L/100-y/2),G=T+M*y;if(n.occludeLowerItems&&v>0&&h>.05){const N=i-T;if(N>.5&&y>.01){const x=N/y;s.value?b=`inset(${x}px 0 0 0)`:b=`inset(0 0 0 ${x}px)`}}i=G,h=S,c[v]={scale:y,translate:L,opacity:S,clipPath:b}})},C=()=>{a.value&&(P.value=Array.from(a.value.querySelectorAll(".slider-item")),_.value.forEach(t=>{c[t]||(c[t]={scale:1,translate:0,opacity:1})}),Object.keys(c).forEach(t=>{const l=Number(t);l>=n.itemCount&&delete c[l]}),r())};e.watch(()=>n.itemCount,(t,l)=>{setTimeout(()=>{C()},0)},{immediate:!1});const p=e.ref(0),R=()=>{if(!a.value)return 0;const t=a.value[s.value?"clientHeight":"clientWidth"];let l=0;if(P.value.length>0){const o=P.value[0];if(o){const i=o.getBoundingClientRect();l=s.value?i.height:i.width}}p.value=Math.max(0,t-l)};return R(),e.onMounted(()=>{if(!a.value)return;const t=a.value;m=new ResizeObserver(()=>r()),m.observe(t),t.addEventListener("scroll",r),window.addEventListener("resize",r),t.addEventListener("touchmove",r,{passive:!0}),C(),e.nextTick(()=>requestAnimationFrame(r))}),e.onUnmounted(()=>{m==null||m.disconnect(),m=null,a.value&&(a.value.removeEventListener("scroll",r),a.value.removeEventListener("touchmove",r)),window.removeEventListener("resize",r)}),e.watch([g,z,E,O,V,B,A],()=>{console.log("Props changed, reinitializing items"),e.nextTick(()=>{r()})}),(t,l)=>(e.openBlock(),e.createElementBlock("div",{class:e.normalizeClass(["slider",{horizontal:!s.value}]),ref_key:"sliderRef",ref:a},[e.unref(B)?(e.openBlock(),e.createElementBlock("div",{key:0,class:"slider-spacer",style:e.normalizeStyle(s.value?{height:`${p.value}px`,minHeight:`${p.value}px`}:{width:`${p.value}px`,minWidth:`${p.value}px`,display:"inline-block"})},[e.renderSlot(t.$slots,"spacer",{size:p.value},void 0,!0)],4)):e.createCommentVNode("",!0),(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(_.value,o=>{var i,h,d,v;return e.openBlock(),e.createElementBlock("div",{key:o,class:"slider-item",style:e.normalizeStyle({zIndex:_.value.length-o})},[e.createElementVNode("div",{class:"slider-slot",style:e.normalizeStyle({transform:`${H.value}(${-((i=c[o])==null?void 0:i.translate)||0}%) scale(${((h=c[o])==null?void 0:h.scale)||1})`,opacity:(d=c[o])==null?void 0:d.opacity,clipPath:(v=c[o])==null?void 0:v.clipPath})},[e.renderSlot(t.$slots,`item-${o}`,{index:o},()=>[e.renderSlot(t.$slots,"item",{index:o},void 0,!0)],!0)],4)],4)}),128))],2))}}),[["__scopeId","data-v-30dc45e5"]]);f.ScrollSlide=F,Object.defineProperty(f,Symbol.toStringTag,{value:"Module"})}));

package/package.json

@@ -1,35 +1,42 @@
-{
-  "name": "scroll-slides",
-  "version": "0.2.0",
-  "type": "module",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "main": "./dist/scroll-slides.umd.cjs",
-  "module": "./dist/scroll-slides.js",
-  "author": {
-    "name": "agoudbg",
-    "email": "agoudbg@gmail.com",
-    "url": "https://github.com/agoudbg"
-  },
-  "homepage": "https://github.com/agoudbg/scroll-slides",
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build && vue-tsc --emitDeclarationOnly --project tsconfig.app.json",
-    "build:demo": "vite build --config vite.demo.config.ts",
-    "types": "vue-tsc --declaration --emitDeclarationOnly --project tsconfig.app.json",
-    "preview": "vite preview"
-  },
-  "dependencies": {
-    "vue": "^3.5.13"
-  },
-  "devDependencies": {
-    "@types/node": "^22.14.0",
-    "@vitejs/plugin-vue": "^5.2.1",
-    "@vue/tsconfig": "^0.7.0",
-    "typescript": "~5.7.2",
-    "vite": "^6.2.0",
-    "vue-tsc": "^2.2.4"
-  }
+{
+  "name": "scroll-slides",
+  "version": "0.3.0",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/scroll-slides.umd.cjs",
+  "module": "./dist/scroll-slides.js",
+  "author": {
+    "name": "agoudbg",
+    "email": "agoudbg@gmail.com",
+    "url": "https://github.com/agoudbg"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/agoudbg/scroll-slides",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && vue-tsc --emitDeclarationOnly --project tsconfig.app.json",
+    "build:demo": "vite build --config vite.demo.config.ts",
+    "types": "vue-tsc --declaration --emitDeclarationOnly --project tsconfig.app.json",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "scroll-slides": "link:..\\..\\..\\AppData\\Local\\pnpm\\global\\5\\node_modules\\scroll-slides",
+    "vue": "^3.5.26"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.7",
+    "@vitejs/plugin-vue": "^5.2.4",
+    "@vue/tsconfig": "^0.7.0",
+    "typescript": "~5.7.3",
+    "vite": "^6.4.1",
+    "vue-tsc": "^2.2.12"
+  },
+  "pnpm": {
+    "overrides": {
+      "scroll-slides": "link:../../../AppData/Local/pnpm/global/5/node_modules/scroll-slides"
+    }
+  }
 }

package/dist/vite.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>