@empathyco/x-components 6.0.0-alpha.17 → 6.0.0-alpha.171

package/js/x-modules/scroll/components/main-scroll.vue.js

@@ -1,178 +1,178 @@
 import { defineComponent, ref, computed, provide, onMounted, getCurrentInstance, onBeforeUnmount, watch } from 'vue';
-import { scrollXModule } from '../x-module.js';
 import { DISABLE_ANIMATIONS_KEY } from '../../../components/decorators/injection.consts.js';
 import { useState } from '../../../composables/use-state.js';
 import { useXBus } from '../../../composables/use-x-bus.js';
+import { scrollXModule } from '../x-module.js';
 import { ScrollObserverKey } from './scroll.const.js';
 
-/**
- * Extends the scroll making it able to sync the first visible element, and allowing
- * the children position to be restored.
- *
- * Each child element that wants to have this support must be wrapped in a {@link MainScrollItem}
- * component.
- *
- * @public
- */
-var _sfc_main = defineComponent({
-    name: 'MainScroll',
-    xModule: scrollXModule.name,
-    props: {
-        /**
-         * If `true`, sets this scroll instance to the main of the application. Being the main
-         * scroll implies that features like restoring the scroll when the query changes, or storing
-         * the scroll position in the URL will be enabled for this container.
-         */
-        useWindow: {
-            type: Boolean,
-            default: false
-        },
-        /**
-         * Timeout in milliseconds to abort trying to restore the scroll position to the target
-         * element.
-         */
-        restoreScrollTimeoutMs: {
-            type: Number,
-            default: 5000
-        },
-        /** Intersection percentage to consider an element visible. */
-        threshold: {
-            type: Number,
-            default: 0.3
-        },
-        /** Adjusts the size of the scroll container bounds. */
-        margin: {
-            type: String,
-            default: '0px'
-        }
-    },
-    setup(props, { slots }) {
-        const xBus = useXBus();
-        /** The reference to the root element of the component. */
-        const rootRef = ref();
-        /** The elements that are currently considered visible. */
-        const intersectingElements = ref([]);
-        /** Intersection observer to determine visibility of the elements. */
-        let intersectionObserver = ref(null);
-        /**
-         * Pending identifier scroll position to restore. If it matches the {@link MainScrollItem} item
-         * `id` property, this component should be scrolled into view.
-         */
-        const { pendingScrollTo } = useState('scroll', ['pendingScrollTo']);
-        /** Disables the animations. */
-        const disableAnimations = computed(() => !!pendingScrollTo.value);
-        provide(DISABLE_ANIMATIONS_KEY, disableAnimations);
-        /**
-         * Removes an element from the {@link MainScroll.intersectingElements} list.
-         *
-         * @param element - The element to remove from the visible elements.
-         */
-        const removeVisibleElement = (element) => {
-            const index = intersectingElements.value.indexOf(element);
-            if (index !== -1) {
-                intersectingElements.value.splice(index, 1);
-            }
-        };
-        /**
-         * Creates an `IntersectionObserver` to detect the first visible elements. Children of this
-         * component should register themselves if they want to be observed.
-         *
-         * @returns The intersection observer.
-         */
-        const visibleElementsObserver = computed(() => {
-            const observer = intersectionObserver.value;
-            return observer
-                ? {
-                    observe: observer.observe.bind(observer),
-                    unobserve: element => {
-                        removeVisibleElement(element);
-                        observer.unobserve(element);
-                    }
-                }
-                : null;
-        });
-        provide(ScrollObserverKey, visibleElementsObserver);
-        /**
-         * Updates the visible elements given a list of intersection observer entries.
-         *
-         * @param entries - The entries from whom update the visibility.
-         */
-        const updateVisibleElements = (entries) => {
-            entries.forEach(entry => {
-                const target = entry.target;
-                if (entry.isIntersecting) {
-                    intersectingElements.value.push(target);
-                }
-                else {
-                    removeVisibleElement(target);
-                }
-            });
-        };
-        /** Stores the root element and initialise the observer after mounting the component. */
-        onMounted(() => {
-            rootRef.value = getCurrentInstance()?.proxy?.$el;
-            if (rootRef.value) {
-                intersectionObserver.value = new IntersectionObserver(updateVisibleElements, {
-                    root: props.useWindow ? document : rootRef.value,
-                    threshold: props.threshold,
-                    rootMargin: props.margin
-                });
-            }
-        });
-        /** Disconnects the intersection observer. */
-        onBeforeUnmount(() => {
-            intersectionObserver.value?.disconnect();
-            xBus.emit('UserScrolledToElement', '');
-        });
-        /** Disconnects the previous observer. */
-        watch(intersectionObserver, (_new, old) => old?.disconnect());
-        /** Stores the identifier of the timeout that will consider the scroll failed to restore. */
-        let restoreScrollFailTimeoutId;
-        /**
-         * If there is a pending scroll, starts a countdown to stop trying to restore the scroll.
-         *
-         * @param pendingScrollTo - The position the scroll should be restored to.
-         */
-        watch(pendingScrollTo, () => {
-            // TODO Move this logic to the wiring. A cancelable delay operator is needed
-            clearTimeout(restoreScrollFailTimeoutId);
-            if (pendingScrollTo.value) {
-                restoreScrollFailTimeoutId = window.setTimeout(() => {
-                    xBus.emit('ScrollRestoreFailed');
-                }, props.restoreScrollTimeoutMs);
-            }
-        });
-        /**
-         * The first visible element contained in this component.
-         *
-         * @returns The first visible element in this component.
-         */
-        const firstVisibleElement = computed(() => {
-            if (intersectingElements.value.length === 0) {
-                return '';
-            }
-            const firstVisibleElement = intersectingElements.value.reduce((firstVisibleElement, anotherElement) => {
-                // FIXME: This algorithm only takes into account LTR layouts
-                const firstVisibleElementBounds = firstVisibleElement.getBoundingClientRect();
-                const anotherElementBounds = anotherElement.getBoundingClientRect();
-                return anotherElementBounds.left <= firstVisibleElementBounds.left &&
-                    anotherElementBounds.top <= firstVisibleElementBounds.top
-                    ? anotherElement
-                    : firstVisibleElement;
-            });
-            return firstVisibleElement === rootRef.value?.querySelector('[data-scroll]')
-                ? ''
-                : firstVisibleElement.dataset.scroll;
-        });
-        watch(firstVisibleElement, () => xBus.emit('UserScrolledToElement', firstVisibleElement.value), { immediate: true });
-        /*
-         * Obtains the vNodes array of the default slot and renders only the first one.
-         * It avoids to render a `Fragment` with the vNodes in Vue3 and the same behaviour in Vue2
-         * because Vue2 only allows a single root node. Then, `getCurrentInstance()?.proxy?.$el` to
-         * retrieve the HTML element in both versions.
-         */
-        return () => slots.default?.()[0] ?? '';
-    }
+/**
+ * Extends the scroll making it able to sync the first visible element, and allowing
+ * the children position to be restored.
+ *
+ * Each child element that wants to have this support must be wrapped in a {@link MainScrollItem}
+ * component.
+ *
+ * @public
+ */
+var _sfc_main = defineComponent({
+    name: 'MainScroll',
+    xModule: scrollXModule.name,
+    props: {
+        /**
+         * If `true`, sets this scroll instance to the main of the application. Being the main
+         * scroll implies that features like restoring the scroll when the query changes, or storing
+         * the scroll position in the URL will be enabled for this container.
+         */
+        useWindow: {
+            type: Boolean,
+            default: false,
+        },
+        /**
+         * Timeout in milliseconds to abort trying to restore the scroll position to the target
+         * element.
+         */
+        restoreScrollTimeoutMs: {
+            type: Number,
+            default: 5000,
+        },
+        /** Intersection percentage to consider an element visible. */
+        threshold: {
+            type: Number,
+            default: 0.3,
+        },
+        /** Adjusts the size of the scroll container bounds. */
+        margin: {
+            type: String,
+            default: '0px',
+        },
+    },
+    setup(props, { slots }) {
+        const xBus = useXBus();
+        /** The reference to the root element of the component. */
+        const rootRef = ref();
+        /** The elements that are currently considered visible. */
+        const intersectingElements = ref([]);
+        /** Intersection observer to determine visibility of the elements. */
+        const intersectionObserver = ref(null);
+        /**
+         * Pending identifier scroll position to restore. If it matches the {@link MainScrollItem} item
+         * `id` property, this component should be scrolled into view.
+         */
+        const { pendingScrollTo } = useState('scroll');
+        /** Disables the animations. */
+        const disableAnimations = computed(() => !!pendingScrollTo.value);
+        provide(DISABLE_ANIMATIONS_KEY, disableAnimations);
+        /**
+         * Removes an element from the {@link MainScroll.intersectingElements} list.
+         *
+         * @param element - The element to remove from the visible elements.
+         */
+        const removeVisibleElement = (element) => {
+            const index = intersectingElements.value.indexOf(element);
+            if (index !== -1) {
+                intersectingElements.value.splice(index, 1);
+            }
+        };
+        /**
+         * Creates an `IntersectionObserver` to detect the first visible elements. Children of this
+         * component should register themselves if they want to be observed.
+         *
+         * @returns The intersection observer.
+         */
+        const visibleElementsObserver = computed(() => {
+            const observer = intersectionObserver.value;
+            return observer
+                ? {
+                    observe: observer.observe.bind(observer),
+                    unobserve: element => {
+                        removeVisibleElement(element);
+                        observer.unobserve(element);
+                    },
+                }
+                : null;
+        });
+        provide(ScrollObserverKey, visibleElementsObserver);
+        /**
+         * Updates the visible elements given a list of intersection observer entries.
+         *
+         * @param entries - The entries from whom update the visibility.
+         */
+        const updateVisibleElements = (entries) => {
+            entries.forEach(entry => {
+                const target = entry.target;
+                if (entry.isIntersecting) {
+                    intersectingElements.value.push(target);
+                }
+                else {
+                    removeVisibleElement(target);
+                }
+            });
+        };
+        /** Stores the root element and initialise the observer after mounting the component. */
+        onMounted(() => {
+            rootRef.value = getCurrentInstance()?.proxy?.$el;
+            if (rootRef.value) {
+                intersectionObserver.value = new IntersectionObserver(updateVisibleElements, {
+                    root: props.useWindow ? document : rootRef.value,
+                    threshold: props.threshold,
+                    rootMargin: props.margin,
+                });
+            }
+        });
+        /** Disconnects the intersection observer. */
+        onBeforeUnmount(() => {
+            intersectionObserver.value?.disconnect();
+            xBus.emit('UserScrolledToElement', '');
+        });
+        /** Disconnects the previous observer. */
+        watch(intersectionObserver, (_new, old) => old?.disconnect());
+        /** Stores the identifier of the timeout that will consider the scroll failed to restore. */
+        let restoreScrollFailTimeoutId;
+        /**
+         * If there is a pending scroll, starts a countdown to stop trying to restore the scroll.
+         *
+         * @param pendingScrollTo - The position the scroll should be restored to.
+         */
+        watch(pendingScrollTo, () => {
+            // TODO Move this logic to the wiring. A cancelable delay operator is needed
+            clearTimeout(restoreScrollFailTimeoutId);
+            if (pendingScrollTo.value) {
+                restoreScrollFailTimeoutId = window.setTimeout(() => {
+                    xBus.emit('ScrollRestoreFailed');
+                }, props.restoreScrollTimeoutMs);
+            }
+        });
+        /**
+         * The first visible element contained in this component.
+         *
+         * @returns The first visible element in this component.
+         */
+        const firstVisibleElement = computed(() => {
+            if (intersectingElements.value.length === 0) {
+                return '';
+            }
+            const firstVisibleElement = intersectingElements.value.reduce((firstVisibleElement, anotherElement) => {
+                // FIXME: This algorithm only takes into account LTR layouts
+                const firstVisibleElementBounds = firstVisibleElement.getBoundingClientRect();
+                const anotherElementBounds = anotherElement.getBoundingClientRect();
+                return anotherElementBounds.left <= firstVisibleElementBounds.left &&
+                    anotherElementBounds.top <= firstVisibleElementBounds.top
+                    ? anotherElement
+                    : firstVisibleElement;
+            });
+            return firstVisibleElement === rootRef.value?.querySelector('[data-scroll]')
+                ? ''
+                : firstVisibleElement.dataset.scroll;
+        });
+        watch(firstVisibleElement, () => xBus.emit('UserScrolledToElement', firstVisibleElement.value), { immediate: true });
+        /*
+         * Obtains the vNodes array of the default slot and renders only the first one.
+         * It avoids to render a `Fragment` with the vNodes in Vue3 and the same behaviour in Vue2
+         * because Vue2 only allows a single root node. Then, `getCurrentInstance()?.proxy?.$el` to
+         * retrieve the HTML element in both versions.
+         */
+        return () => slots.default?.()[0] ?? '';
+    },
 });
 
 export { _sfc_main as default };

package/js/x-modules/scroll/components/main-scroll.vue.js.map

@@ -1 +1 @@
-{"version":3,"file":"main-scroll.vue.js","sources":["../../../../../src/x-modules/scroll/components/main-scroll.vue"],"sourcesContent":["<script lang=\"ts\">\n  import {\n    computed,\n    defineComponent,\n    getCurrentInstance,\n    onBeforeUnmount,\n    onMounted,\n    provide,\n    ref,\n    watch\n  } from 'vue';\n  import { scrollXModule } from '../x-module';\n  import { DISABLE_ANIMATIONS_KEY } from '../../../components/decorators/injection.consts';\n  import { useState } from '../../../composables/use-state';\n  import { useXBus } from '../../../composables/use-x-bus';\n  import { ScrollObserverKey } from './scroll.const';\n  import { ScrollVisibilityObserver } from './scroll.types';\n\n  /**\n   * Extends the scroll making it able to sync the first visible element, and allowing\n   * the children position to be restored.\n   *\n   * Each child element that wants to have this support must be wrapped in a {@link MainScrollItem}\n   * component.\n   *\n   * @public\n   */\n  export default defineComponent({\n    name: 'MainScroll',\n    xModule: scrollXModule.name,\n    props: {\n      /**\n       * If `true`, sets this scroll instance to the main of the application. Being the main\n       * scroll implies that features like restoring the scroll when the query changes, or storing\n       * the scroll position in the URL will be enabled for this container.\n       */\n      useWindow: {\n        type: Boolean,\n        default: false\n      },\n      /**\n       * Timeout in milliseconds to abort trying to restore the scroll position to the target\n       * element.\n       */\n      restoreScrollTimeoutMs: {\n        type: Number,\n        default: 5000\n      },\n      /** Intersection percentage to consider an element visible. */\n      threshold: {\n        type: Number,\n        default: 0.3\n      },\n      /** Adjusts the size of the scroll container bounds. */\n      margin: {\n        type: String,\n        default: '0px'\n      }\n    },\n    setup(props, { slots }) {\n      const xBus = useXBus();\n\n      /** The reference to the root element of the component. */\n      const rootRef = ref<Element>();\n      /** The elements that are currently considered visible. */\n      const intersectingElements = ref<HTMLElement[]>([]);\n\n      /** Intersection observer to determine visibility of the elements. */\n      let intersectionObserver = ref<IntersectionObserver | null>(null);\n\n      /**\n       * Pending identifier scroll position to restore. If it matches the {@link MainScrollItem} item\n       * `id` property, this component should be scrolled into view.\n       */\n      const { pendingScrollTo } = useState('scroll', ['pendingScrollTo']);\n\n      /** Disables the animations. */\n      const disableAnimations = computed((): boolean => !!pendingScrollTo.value);\n      provide(DISABLE_ANIMATIONS_KEY as string, disableAnimations);\n\n      /**\n       * Removes an element from the {@link MainScroll.intersectingElements} list.\n       *\n       * @param element - The element to remove from the visible elements.\n       */\n      const removeVisibleElement = (element: HTMLElement) => {\n        const index = intersectingElements.value.indexOf(element);\n        if (index !== -1) {\n          intersectingElements.value.splice(index, 1);\n        }\n      };\n\n      /**\n       * Creates an `IntersectionObserver` to detect the first visible elements. Children of this\n       * component should register themselves if they want to be observed.\n       *\n       * @returns The intersection observer.\n       */\n      const visibleElementsObserver = computed((): ScrollVisibilityObserver | null => {\n        const observer = intersectionObserver.value;\n        return observer\n          ? {\n              observe: observer.observe.bind(observer),\n              unobserve: element => {\n                removeVisibleElement(element);\n                observer.unobserve(element);\n              }\n            }\n          : null;\n      });\n      provide(ScrollObserverKey as string, visibleElementsObserver);\n\n      /**\n       * Updates the visible elements given a list of intersection observer entries.\n       *\n       * @param entries - The entries from whom update the visibility.\n       */\n      const updateVisibleElements = (entries: IntersectionObserverEntry[]) => {\n        entries.forEach(entry => {\n          const target = entry.target as HTMLElement;\n          if (entry.isIntersecting) {\n            intersectingElements.value.push(target);\n          } else {\n            removeVisibleElement(target);\n          }\n        });\n      };\n\n      /** Stores the root element and initialise the observer after mounting the component. */\n      onMounted(() => {\n        rootRef.value = getCurrentInstance()?.proxy?.$el;\n        if (rootRef.value) {\n          intersectionObserver.value = new IntersectionObserver(updateVisibleElements, {\n            root: props.useWindow ? document : rootRef.value,\n            threshold: props.threshold,\n            rootMargin: props.margin\n          });\n        }\n      });\n\n      /** Disconnects the intersection observer. */\n      onBeforeUnmount(() => {\n        intersectionObserver.value?.disconnect();\n        xBus.emit('UserScrolledToElement', '');\n      });\n\n      /** Disconnects the previous observer. */\n      watch(intersectionObserver, (_new, old) => old?.disconnect());\n\n      /** Stores the identifier of the timeout that will consider the scroll failed to restore. */\n      let restoreScrollFailTimeoutId: number;\n\n      /**\n       * If there is a pending scroll, starts a countdown to stop trying to restore the scroll.\n       *\n       * @param pendingScrollTo - The position the scroll should be restored to.\n       */\n      watch(pendingScrollTo, () => {\n        // TODO Move this logic to the wiring. A cancelable delay operator is needed\n        clearTimeout(restoreScrollFailTimeoutId);\n        if (pendingScrollTo.value) {\n          restoreScrollFailTimeoutId = window.setTimeout(() => {\n            xBus.emit('ScrollRestoreFailed');\n          }, props.restoreScrollTimeoutMs);\n        }\n      });\n\n      /**\n       * The first visible element contained in this component.\n       *\n       * @returns The first visible element in this component.\n       */\n      const firstVisibleElement = computed(() => {\n        if (intersectingElements.value.length === 0) {\n          return '';\n        }\n        const firstVisibleElement = intersectingElements.value.reduce(\n          (firstVisibleElement, anotherElement) => {\n            // FIXME: This algorithm only takes into account LTR layouts\n            const firstVisibleElementBounds = firstVisibleElement.getBoundingClientRect();\n            const anotherElementBounds = anotherElement.getBoundingClientRect();\n            return anotherElementBounds.left <= firstVisibleElementBounds.left &&\n              anotherElementBounds.top <= firstVisibleElementBounds.top\n              ? anotherElement\n              : firstVisibleElement;\n          }\n        );\n        return firstVisibleElement === rootRef.value?.querySelector('[data-scroll]')\n          ? ''\n          : firstVisibleElement.dataset.scroll!;\n      });\n\n      watch(\n        firstVisibleElement,\n        () => xBus.emit('UserScrolledToElement', firstVisibleElement.value),\n        { immediate: true }\n      );\n\n      /*\n       * Obtains the vNodes array of the default slot and renders only the first one.\n       * It avoids to render a `Fragment` with the vNodes in Vue3 and the same behaviour in Vue2\n       * because Vue2 only allows a single root node. Then, `getCurrentInstance()?.proxy?.$el` to\n       * retrieve the HTML element in both versions.\n       */\n      return () => slots.default?.()[0] ?? '';\n    }\n  });\n</script>\n\n<docs lang=\"mdx\">\n## Events\n\nThis component emits the following events:\n\n- [`UserScrolledToElement`](https://github.com/empathyco/x/blob/main/packages/x-components/src/wiring/events.types.ts)\n- [`ScrollRestoreFailed`](https://github.com/empathyco/x/blob/main/packages/x-components/src/wiring/events.types.ts)\n\n## See it in action\n\nThe `MainScroll` component must be an ancestor of the `MainScrollItem` components. This is because\nit injects the needed utilities to determine the first visible item.\n\n```vue\n<template>\n  <MainScroll>\n    <ul>\n      <MainScrollItem v-for=\"item in 24\" tag=\"li\">Item {{ item }}</MainScrollItem>\n    </ul>\n  </MainScroll>\n</template>\n\n<script>\n  import { MainScroll, MainScrollItem } from '@empathyco/x-components/scroll';\n\n  export default {\n    name: 'MainScrollDemo',\n    components: {\n      MainScroll,\n      MainScrollItem\n    }\n  };\n</script>\n\n<style lang=\"css\" scoped>\n  ul {\n    overflow: auto;\n    max-height: 200px;\n  }\n\n  li {\n    height: 50px;\n    line-height: 50px;\n  }\n</style>\n```\n\n### Play with props\n\n#### Window scroll\n\nIn case you aren't using a custom scrolling element like the `Scroll` panel, and want to use the\ndefault browser scroll, you can do so by using the `useWindow` prop:\n\n```vue\n<template>\n  <MainScroll useWindow>\n    <ul>\n      <MainScrollItem v-for=\"item in 24\" tag=\"li\">Item {{ item }}</MainScrollItem>\n    </ul>\n  </MainScroll>\n</template>\n\n<script>\n  import { MainScroll, MainScrollItem } from '@empathyco/x-components/scroll';\n\n  export default {\n    name: 'MainScrollDemo',\n    components: {\n      MainScroll,\n      MainScrollItem\n    }\n  };\n</script>\n```\n\n#### Timeout for restoring scroll\n\nWhen your application is loaded, this component, together with the `MainScrollItem` will try to\nrestore the scroll to the provided position (if available). Because of the dynamic nature of\nJavaScript applications, the element that it tries to restore the scroll to might not be available\nanymore. For this reason after a defined time, the scroll restoration will be considered failed.\n\nThis time can be configured through the `restore-scroll-timeout-ms` prop. This is specially useful\nwhen combined with the URL X Module.\n\n```vue\n<template>\n  <MainScroll :restoreScrollTimeoutMs=\"1000\">\n    <ul>\n      <MainScrollItem v-for=\"item in 24\" tag=\"li\">Item {{ item }}</MainScrollItem>\n    </ul>\n  </MainScroll>\n</template>\n\n<script>\n  import { MainScroll, MainScrollItem } from '@empathyco/x-components/scroll';\n\n  export default {\n    name: 'MainScrollDemo',\n    components: {\n      MainScroll,\n      MainScrollItem\n    }\n  };\n</script>\n```\n\n#### Adjust first visible item\n\nBy default this component will consider the first visible item, the first element that is at least\nintersecting a 50% with its container. However this arbitrary number might not always be the best.\n\nTo configure this, you can use the `margin` and `threshold` props, which work exactly like in the\n`IntersectionObserver` API. In this example we are reducing the bounds of the intersection by 50px,\nand adjusting the element to be at least 75% intersecting.\n\n```vue\n<template>\n  <MainScroll :threshold=\"0.75\" margin=\"-50px\">\n    <ul>\n      <MainScrollItem v-for=\"item in 24\" tag=\"li\">Item {{ item }}</MainScrollItem>\n    </ul>\n  </MainScroll>\n</template>\n\n<script>\n  import { MainScroll, MainScrollItem } from '@empathyco/x-components/scroll';\n\n  export default {\n    name: 'MainScrollDemo',\n    components: {\n      MainScroll,\n      MainScrollItem\n    }\n  };\n</script>\n```\n</docs>\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"main-scroll.vue.js","sources":["../../../../../src/x-modules/scroll/components/main-scroll.vue"],"sourcesContent":["<script lang=\"ts\">\nimport type { ScrollVisibilityObserver } from './scroll.types'\nimport {\n  computed,\n  defineComponent,\n  getCurrentInstance,\n  onBeforeUnmount,\n  onMounted,\n  provide,\n  ref,\n  watch,\n} from 'vue'\nimport { DISABLE_ANIMATIONS_KEY } from '../../../components/decorators/injection.consts'\nimport { useState } from '../../../composables/use-state'\nimport { useXBus } from '../../../composables/use-x-bus'\nimport { scrollXModule } from '../x-module'\nimport { ScrollObserverKey } from './scroll.const'\n\n/**\n * Extends the scroll making it able to sync the first visible element, and allowing\n * the children position to be restored.\n *\n * Each child element that wants to have this support must be wrapped in a {@link MainScrollItem}\n * component.\n *\n * @public\n */\nexport default defineComponent({\n  name: 'MainScroll',\n  xModule: scrollXModule.name,\n  props: {\n    /**\n     * If `true`, sets this scroll instance to the main of the application. Being the main\n     * scroll implies that features like restoring the scroll when the query changes, or storing\n     * the scroll position in the URL will be enabled for this container.\n     */\n    useWindow: {\n      type: Boolean,\n      default: false,\n    },\n    /**\n     * Timeout in milliseconds to abort trying to restore the scroll position to the target\n     * element.\n     */\n    restoreScrollTimeoutMs: {\n      type: Number,\n      default: 5000,\n    },\n    /** Intersection percentage to consider an element visible. */\n    threshold: {\n      type: Number,\n      default: 0.3,\n    },\n    /** Adjusts the size of the scroll container bounds. */\n    margin: {\n      type: String,\n      default: '0px',\n    },\n  },\n  setup(props, { slots }) {\n    const xBus = useXBus()\n\n    /** The reference to the root element of the component. */\n    const rootRef = ref<Element>()\n    /** The elements that are currently considered visible. */\n    const intersectingElements = ref<HTMLElement[]>([])\n\n    /** Intersection observer to determine visibility of the elements. */\n    const intersectionObserver = ref<IntersectionObserver | null>(null)\n\n    /**\n     * Pending identifier scroll position to restore. If it matches the {@link MainScrollItem} item\n     * `id` property, this component should be scrolled into view.\n     */\n    const { pendingScrollTo } = useState('scroll')\n\n    /** Disables the animations. */\n    const disableAnimations = computed((): boolean => !!pendingScrollTo.value)\n    provide(DISABLE_ANIMATIONS_KEY as string, disableAnimations)\n\n    /**\n     * Removes an element from the {@link MainScroll.intersectingElements} list.\n     *\n     * @param element - The element to remove from the visible elements.\n     */\n    const removeVisibleElement = (element: HTMLElement) => {\n      const index = intersectingElements.value.indexOf(element)\n      if (index !== -1) {\n        intersectingElements.value.splice(index, 1)\n      }\n    }\n\n    /**\n     * Creates an `IntersectionObserver` to detect the first visible elements. Children of this\n     * component should register themselves if they want to be observed.\n     *\n     * @returns The intersection observer.\n     */\n    const visibleElementsObserver = computed((): ScrollVisibilityObserver | null => {\n      const observer = intersectionObserver.value\n      return observer\n        ? {\n            observe: observer.observe.bind(observer),\n            unobserve: element => {\n              removeVisibleElement(element)\n              observer.unobserve(element)\n            },\n          }\n        : null\n    })\n    provide(ScrollObserverKey as string, visibleElementsObserver)\n\n    /**\n     * Updates the visible elements given a list of intersection observer entries.\n     *\n     * @param entries - The entries from whom update the visibility.\n     */\n    const updateVisibleElements = (entries: IntersectionObserverEntry[]) => {\n      entries.forEach(entry => {\n        const target = entry.target as HTMLElement\n        if (entry.isIntersecting) {\n          intersectingElements.value.push(target)\n        } else {\n          removeVisibleElement(target)\n        }\n      })\n    }\n\n    /** Stores the root element and initialise the observer after mounting the component. */\n    onMounted(() => {\n      rootRef.value = getCurrentInstance()?.proxy?.$el\n      if (rootRef.value) {\n        intersectionObserver.value = new IntersectionObserver(updateVisibleElements, {\n          root: props.useWindow ? document : rootRef.value,\n          threshold: props.threshold,\n          rootMargin: props.margin,\n        })\n      }\n    })\n\n    /** Disconnects the intersection observer. */\n    onBeforeUnmount(() => {\n      intersectionObserver.value?.disconnect()\n      xBus.emit('UserScrolledToElement', '')\n    })\n\n    /** Disconnects the previous observer. */\n    watch(intersectionObserver, (_new, old) => old?.disconnect())\n\n    /** Stores the identifier of the timeout that will consider the scroll failed to restore. */\n    let restoreScrollFailTimeoutId: number\n\n    /**\n     * If there is a pending scroll, starts a countdown to stop trying to restore the scroll.\n     *\n     * @param pendingScrollTo - The position the scroll should be restored to.\n     */\n    watch(pendingScrollTo, () => {\n      // TODO Move this logic to the wiring. A cancelable delay operator is needed\n      clearTimeout(restoreScrollFailTimeoutId)\n      if (pendingScrollTo.value) {\n        restoreScrollFailTimeoutId = window.setTimeout(() => {\n          xBus.emit('ScrollRestoreFailed')\n        }, props.restoreScrollTimeoutMs)\n      }\n    })\n\n    /**\n     * The first visible element contained in this component.\n     *\n     * @returns The first visible element in this component.\n     */\n    const firstVisibleElement = computed(() => {\n      if (intersectingElements.value.length === 0) {\n        return ''\n      }\n      const firstVisibleElement = intersectingElements.value.reduce(\n        (firstVisibleElement, anotherElement) => {\n          // FIXME: This algorithm only takes into account LTR layouts\n          const firstVisibleElementBounds = firstVisibleElement.getBoundingClientRect()\n          const anotherElementBounds = anotherElement.getBoundingClientRect()\n          return anotherElementBounds.left <= firstVisibleElementBounds.left &&\n            anotherElementBounds.top <= firstVisibleElementBounds.top\n            ? anotherElement\n            : firstVisibleElement\n        },\n      )\n      return firstVisibleElement === rootRef.value?.querySelector('[data-scroll]')\n        ? ''\n        : firstVisibleElement.dataset.scroll!\n    })\n\n    watch(\n      firstVisibleElement,\n      () => xBus.emit('UserScrolledToElement', firstVisibleElement.value),\n      { immediate: true },\n    )\n\n    /*\n     * Obtains the vNodes array of the default slot and renders only the first one.\n     * It avoids to render a `Fragment` with the vNodes in Vue3 and the same behaviour in Vue2\n     * because Vue2 only allows a single root node. Then, `getCurrentInstance()?.proxy?.$el` to\n     * retrieve the HTML element in both versions.\n     */\n    return () => slots.default?.()[0] ?? ''\n  },\n})\n</script>\n\n<docs lang=\"mdx\">\n## Events\n\nThis component emits the following events:\n\n- [`UserScrolledToElement`](https://github.com/empathyco/x/blob/main/packages/x-components/src/wiring/events.types.ts)\n- [`ScrollRestoreFailed`](https://github.com/empathyco/x/blob/main/packages/x-components/src/wiring/events.types.ts)\n\n## See it in action\n\nThe `MainScroll` component must be an ancestor of the `MainScrollItem` components. This is because\nit injects the needed utilities to determine the first visible item.\n\n```vue\n<template>\n  <MainScroll>\n    <ul>\n      <MainScrollItem v-for=\"item in 24\" tag=\"li\">Item {{ item }}</MainScrollItem>\n    </ul>\n  </MainScroll>\n</template>\n\n<script>\nimport { MainScroll, MainScrollItem } from '@empathyco/x-components/scroll'\n\nexport default {\n  name: 'MainScrollDemo',\n  components: {\n    MainScroll,\n    MainScrollItem,\n  },\n}\n</script>\n\n<style lang=\"css\" scoped>\nul {\n  overflow: auto;\n  max-height: 200px;\n}\n\nli {\n  height: 50px;\n  line-height: 50px;\n}\n</style>\n```\n\n### Play with props\n\n#### Window scroll\n\nIn case you aren't using a custom scrolling element like the `Scroll` panel, and want to use the\ndefault browser scroll, you can do so by using the `useWindow` prop:\n\n```vue\n<template>\n  <MainScroll useWindow>\n    <ul>\n      <MainScrollItem v-for=\"item in 24\" tag=\"li\">Item {{ item }}</MainScrollItem>\n    </ul>\n  </MainScroll>\n</template>\n\n<script>\nimport { MainScroll, MainScrollItem } from '@empathyco/x-components/scroll'\n\nexport default {\n  name: 'MainScrollDemo',\n  components: {\n    MainScroll,\n    MainScrollItem,\n  },\n}\n</script>\n```\n\n#### Timeout for restoring scroll\n\nWhen your application is loaded, this component, together with the `MainScrollItem` will try to\nrestore the scroll to the provided position (if available). Because of the dynamic nature of\nJavaScript applications, the element that it tries to restore the scroll to might not be available\nanymore. For this reason after a defined time, the scroll restoration will be considered failed.\n\nThis time can be configured through the `restore-scroll-timeout-ms` prop. This is specially useful\nwhen combined with the URL X Module.\n\n```vue\n<template>\n  <MainScroll :restoreScrollTimeoutMs=\"1000\">\n    <ul>\n      <MainScrollItem v-for=\"item in 24\" tag=\"li\">Item {{ item }}</MainScrollItem>\n    </ul>\n  </MainScroll>\n</template>\n\n<script>\nimport { MainScroll, MainScrollItem } from '@empathyco/x-components/scroll'\n\nexport default {\n  name: 'MainScrollDemo',\n  components: {\n    MainScroll,\n    MainScrollItem,\n  },\n}\n</script>\n```\n\n#### Adjust first visible item\n\nBy default this component will consider the first visible item, the first element that is at least\nintersecting a 50% with its container. However this arbitrary number might not always be the best.\n\nTo configure this, you can use the `margin` and `threshold` props, which work exactly like in the\n`IntersectionObserver` API. In this example we are reducing the bounds of the intersection by 50px,\nand adjusting the element to be at least 75% intersecting.\n\n```vue\n<template>\n  <MainScroll :threshold=\"0.75\" margin=\"-50px\">\n    <ul>\n      <MainScrollItem v-for=\"item in 24\" tag=\"li\">Item {{ item }}</MainScrollItem>\n    </ul>\n  </MainScroll>\n</template>\n\n<script>\nimport { MainScroll, MainScrollItem } from '@empathyco/x-components/scroll'\n\nexport default {\n  name: 'MainScrollDemo',\n  components: {\n    MainScroll,\n    MainScrollItem,\n  },\n}\n</script>\n```\n</docs>\n"],"names":[],"mappings":";;;;;;;AAkBA;;;;;;;;AAQE;AACF,gBAAe,eAAe,CAAC;AAC7B,IAAA,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,aAAa,CAAC,IAAI;AAC3B,IAAA,KAAK,EAAE;AACL;;;;AAIE;AACF,QAAA,SAAS,EAAE;AACT,YAAA,IAAI,EAAE,OAAO;AACb,YAAA,OAAO,EAAE,KAAK;AACf,SAAA;AACD;;;AAGE;AACF,QAAA,sBAAsB,EAAE;AACtB,YAAA,IAAI,EAAE,MAAM;AACZ,YAAA,OAAO,EAAE,IAAI;AACd,SAAA;;AAED,QAAA,SAAS,EAAE;AACT,YAAA,IAAI,EAAE,MAAM;AACZ,YAAA,OAAO,EAAE,GAAG;AACb,SAAA;;AAED,QAAA,MAAM,EAAE;AACN,YAAA,IAAI,EAAE,MAAM;AACZ,YAAA,OAAO,EAAE,KAAK;AACf,SAAA;AACF,KAAA;AACD,IAAA,KAAK,CAAC,KAAK,EAAE,EAAE,KAAI,EAAG,EAAA;AACpB,QAAA,MAAM,IAAG,GAAI,OAAO,EAAC,CAAA;;AAGrB,QAAA,MAAM,OAAQ,GAAE,GAAG,EAAU,CAAA;;AAE7B,QAAA,MAAM,oBAAqB,GAAE,GAAG,CAAgB,EAAE,CAAA,CAAA;;AAGlD,QAAA,MAAM,oBAAqB,GAAE,GAAG,CAA8B,IAAI,CAAA,CAAA;AAElE;;;AAGE;QACF,MAAM,EAAE,eAAgB,EAAA,GAAI,QAAQ,CAAC,QAAQ,CAAA,CAAA;;AAG7C,QAAA,MAAM,iBAAgB,GAAI,QAAQ,CAAC,MAAe,CAAC,CAAC,eAAe,CAAC,KAAK,CAAA,CAAA;AACzE,QAAA,OAAO,CAAC,sBAAgC,EAAE,iBAAiB,CAAA,CAAA;AAE3D;;;;AAIE;AACF,QAAA,MAAM,uBAAuB,CAAC,OAAoB,KAAK;YACrD,MAAM,KAAI,GAAI,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAA,CAAA;AACxD,YAAA,IAAI,KAAM,KAAI,CAAC,CAAC,EAAE;gBAChB,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA,CAAA;aAC5C;AACF,SAAA,CAAA;AAEA;;;;;AAKE;AACF,QAAA,MAAM,uBAAsB,GAAI,QAAQ,CAAC,MAAuC;AAC9E,YAAA,MAAM,QAAS,GAAE,oBAAoB,CAAC,KAAI,CAAA;AAC1C,YAAA,OAAO,QAAO;AACZ,kBAAE;oBACE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;oBACxC,SAAS,EAAE,OAAM,IAAK;wBACpB,oBAAoB,CAAC,OAAO,CAAA,CAAA;AAC5B,wBAAA,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAA,CAAA;qBAC3B;AACH,iBAAA;kBACA,IAAG,CAAA;AACT,SAAC,CAAA,CAAA;AACD,QAAA,OAAO,CAAC,iBAA2B,EAAE,uBAAuB,CAAA,CAAA;AAE5D;;;;AAIE;AACF,QAAA,MAAM,qBAAoB,GAAI,CAAC,OAAoC,KAAK;AACtE,YAAA,OAAO,CAAC,OAAO,CAAC,KAAM,IAAG;AACvB,gBAAA,MAAM,SAAS,KAAK,CAAC,MAAoB,CAAA;AACzC,gBAAA,IAAI,KAAK,CAAC,cAAc,EAAE;AACxB,oBAAA,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAA,CAAA;iBACtC;qBAAK;oBACL,oBAAoB,CAAC,MAAM,CAAA,CAAA;iBAC7B;AACF,aAAC,CAAA,CAAA;AACH,SAAA,CAAA;;QAGA,SAAS,CAAC,MAAM;YACd,OAAO,CAAC,KAAI,GAAI,kBAAkB,EAAE,EAAE,KAAK,EAAE,GAAE,CAAA;AAC/C,YAAA,IAAI,OAAO,CAAC,KAAK,EAAE;AACjB,gBAAA,oBAAoB,CAAC,KAAI,GAAI,IAAI,oBAAoB,CAAC,qBAAqB,EAAE;AAC3E,oBAAA,IAAI,EAAE,KAAK,CAAC,SAAU,GAAE,QAAO,GAAI,OAAO,CAAC,KAAK;oBAChD,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,UAAU,EAAE,KAAK,CAAC,MAAM;AACzB,iBAAA,CAAA,CAAA;aACH;AACF,SAAC,CAAA,CAAA;;QAGD,eAAe,CAAC,MAAM;AACpB,YAAA,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAC,CAAA;AACvC,YAAA,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAA,CAAA;AACvC,SAAC,CAAA,CAAA;;AAGD,QAAA,KAAK,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,EAAE,UAAU,EAAE,CAAA,CAAA;;AAG5D,QAAA,IAAI,0BAAiC,CAAA;AAErC;;;;AAIE;AACF,QAAA,KAAK,CAAC,eAAe,EAAE,MAAM;;YAE3B,YAAY,CAAC,0BAA0B,CAAA,CAAA;AACvC,YAAA,IAAI,eAAe,CAAC,KAAK,EAAE;AACzB,gBAAA,0BAA2B,GAAE,MAAM,CAAC,UAAU,CAAC,MAAM;AACnD,oBAAA,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAA,CAAA;AACjC,iBAAC,EAAE,KAAK,CAAC,sBAAsB,CAAA,CAAA;aACjC;AACF,SAAC,CAAA,CAAA;AAED;;;;AAIE;AACF,QAAA,MAAM,mBAAkB,GAAI,QAAQ,CAAC,MAAM;YACzC,IAAI,oBAAoB,CAAC,KAAK,CAAC,MAAK,KAAM,CAAC,EAAE;AAC3C,gBAAA,OAAO,EAAC,CAAA;aACV;AACA,YAAA,MAAM,mBAAoB,GAAE,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAC3D,CAAC,mBAAmB,EAAE,cAAc,KAAK;;AAEvC,gBAAA,MAAM,yBAA0B,GAAE,mBAAmB,CAAC,qBAAqB,EAAC,CAAA;AAC5E,gBAAA,MAAM,oBAAmB,GAAI,cAAc,CAAC,qBAAqB,EAAC,CAAA;AAClE,gBAAA,OAAO,oBAAoB,CAAC,IAAK,IAAG,yBAAyB,CAAC;AAC5D,oBAAA,oBAAoB,CAAC,GAAI,IAAG,yBAAyB,CAAC,GAAE;AACxD,sBAAE,cAAa;sBACb,mBAAkB,CAAA;AACxB,aAAC,CACH,CAAA;YACA,OAAO,mBAAoB,KAAI,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAA;AACzE,kBAAE,EAAC;AACH,kBAAE,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAA;AACxC,SAAC,CAAA,CAAA;QAED,KAAK,CACH,mBAAmB,EACnB,MAAM,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,mBAAmB,CAAC,KAAK,CAAC,EACnE,EAAE,SAAS,EAAE,MAAM,CACrB,CAAA;AAEA;;;;;AAKE;AACF,QAAA,OAAO,MAAM,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAE,IAAG,EAAC,CAAA;KACvC;AACF,CAAA,CAAA;;;;"}

package/js/x-modules/scroll/components/scroll-to-top.vue.js

@@ -1,5 +1,5 @@
 import _sfc_main from './scroll-to-top.vue2.js';
-import { resolveComponent, openBlock, createBlock, resolveDynamicComponent, withCtx, createCommentVNode, renderSlot } from 'vue';
+import { resolveComponent, openBlock, createBlock, resolveDynamicComponent, withCtx, renderSlot, createCommentVNode } from 'vue';
 import _export_sfc from '../../../_virtual/_plugin-vue_export-helper.js';
 
 function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
@@ -14,7 +14,6 @@ function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
         events: _ctx.events
       }, {
         default: withCtx(() => [
-          createCommentVNode(" @slot (Required) Button content with a text, an icon or both "),
           renderSlot(_ctx.$slots, "default")
         ]),
         _: 3

package/js/x-modules/scroll/components/scroll-to-top.vue.js.map

@@ -1 +1 @@
-{"version":3,"file":"scroll-to-top.vue.js","sources":["../../../../../src/x-modules/scroll/components/scroll-to-top.vue"],"sourcesContent":["<template>\n  <component :is=\"animation\">\n    <BaseEventButton\n      v-if=\"isVisible\"\n      class=\"x-scroll-to-top x-button\"\n      data-test=\"scroll-to-top\"\n      aria-label=\"Scroll to top\"\n      :events=\"events\"\n    >\n      <!-- @slot (Required) Button content with a text, an icon or both -->\n      <slot />\n    </BaseEventButton>\n  </component>\n</template>\n\n<script lang=\"ts\">\n  import { computed, defineComponent } from 'vue';\n  import { NoAnimation, BaseEventButton } from '../../../components';\n  import { XEventsTypes } from '../../../wiring';\n  import { scrollXModule } from '../x-module';\n  import { AnimationProp } from '../../../types';\n  import { useState } from '../../../composables';\n  import { MainScrollId } from './scroll.const';\n\n  /**\n   * The `ScrollToTop` component is a button that the user can click to make a container scroll\n   * up to its initial position.\n   *\n   * @public\n   */\n  export default defineComponent({\n    name: 'ScrollToTop',\n    xModule: scrollXModule.name,\n    components: { BaseEventButton },\n    props: {\n      /**\n       * Animation to use for showing/hiding the button.\n       *\n       * @public\n       */\n      animation: {\n        type: AnimationProp,\n        default: () => NoAnimation\n      },\n      /**\n       * Threshold in pixels from the top to show the button.\n       *\n       * @public\n       */\n      thresholdPx: Number,\n      /**\n       * Id of the target scroll component.\n       *\n       * @public\n       */\n      scrollId: {\n        type: String,\n        default: MainScrollId\n      }\n    },\n    setup(props) {\n      /**\n       * State of all the scroll components in this module.\n       *\n       * @internal\n       */\n      // TODO: Directly retrieve the needed data in this computed property\n      const { data } = useState('scroll', ['data']);\n\n      /**\n       * The scroll data retrieved for this component.\n       *\n       * @returns The scroll data for this component if a valid {@link ScrollToTop.scrollId} has been\n       * passed. Otherwise it returns `null`.\n       * @internal\n       */\n      const scrollData = computed(() => {\n        return props.scrollId && data.value[props.scrollId]\n          ? data.value[props.scrollId]\n          : {\n              position: 0,\n              direction: 'UP',\n              hasReachedStart: false,\n              hasAlmostReachedEnd: false,\n              hasReachedEnd: false\n            };\n      });\n\n      /**\n       * Event that will be emitted when the scroll to top is clicked.\n       *\n       * @returns The event to be emitted when the scroll to top is clicked. The id as a payload.\n       * @internal\n       */\n      const events = computed(\n        (): Partial<XEventsTypes> => ({ UserClickedScrollToTop: props.scrollId })\n      );\n\n      /**\n       * Checks if the thresholdPx prop has been provided and if it is a number.\n       *\n       * @returns If the thresholdPx is a number or not.\n       * @internal\n       */\n      const useThresholdStrategy = computed(() => typeof props.thresholdPx === 'number');\n\n      /**\n       * Checks if the threshold has been reached in case the threshold strategy is in use.\n       *\n       * @returns If the scrollTop is bigger than the thresholdPx.\n       * @internal\n       */\n      const isThresholdReached = computed(\n        () => useThresholdStrategy.value && scrollData.value.position > props.thresholdPx!\n      );\n\n      /**\n       * Returns if the scroll has almost reached its end or not.\n       *\n       * @returns True if the scroll has almost reached the end and the user is still scrolling down.\n       * @internal\n       */\n      const hasAlmostReachedScrollEnd = computed(\n        () => scrollData.value.hasAlmostReachedEnd && scrollData.value.direction === 'DOWN'\n      );\n\n      /**\n       * Whether if the button is visible or not depending on the strategy being used.\n       *\n       * @returns If the button should be visible or not.\n       * @internal\n       */\n      const isVisible = computed(() =>\n        useThresholdStrategy.value ? isThresholdReached.value : hasAlmostReachedScrollEnd.value\n      );\n\n      return {\n        events,\n        isVisible\n      };\n    }\n  });\n</script>\n\n<docs lang=\"mdx\">\n## Events\n\nA list of events that the component will emit:\n\n- [`UserClickedScrollToTop`](https://github.com/empathyco/x/blob/main/packages/x-components/src/wiring/events.types.ts):\n  the event is emitted after the user clicks the button. The event payload is the id of the scroll\n  that it going to be scrolled.\n\n## Examples\n\n### Basic example\n\nThe component renders whatever is passed to it in the default slot and scrolls to top the scroll\nwith an id `scrollId`.\n\nIt also receives an optional threshold in pixels. When the threshold is reached from the top, the\ncomponent will be shown once the user scrolls `UP`.\n\nIf this parameter is not provided the button will be visible when the user almost reaches the end of\nthe scroll.\n\n```vue\n<template>\n  <div>\n    <ScrollToTop scroll-id=\"scrollId\" :threshold-px=\"1000\">\n      <span>Scroll to top</span>\n    </ScrollToTop>\n  </div>\n</template>\n\n<script>\n  import { ScrollToTop } from '@empathyco/x-components/scroll';\n\n  export default {\n    name: 'ScrollToTopTest',\n    components: {\n      ScrollToTop\n    }\n  };\n</script>\n```\n</docs>\n"],"names":["_resolveComponent","animation","isVisible","_createBlock","_resolveDynamicComponent","_withCtx","events","_createCommentVNode","_renderSlot"],"mappings":";;;;;AAYc,EAAA,MAAA,0BAAA,GAAAA,gBAAA,CAZd,iBACkBC,CAAAA,CAAAA;SAENC,SAAS,EAAA,EAAAC,WAAA,CAAAC,uBAAA,CAAA,IAAA,CAAA,SAAA,CAAA,EAAA,IAAA,EAAA;AAAA,IADjB,OAAA,EAAAC,OAAA,CAAA,MAAA;AAAA,MAAA,IAAA,CAFJ,wBAIsC,EAAAF,WAAA,CAAA,0BAAA,EAAA;AAAA,QAChC,GAAA,EAAA,CAAA;AAAA,QACA,KAAA,EAAA,0BAAA;AAAA,QACC,WAAQG,EAAAA,eAAAA;AAAAA,QAAAA,YAAAA,EAAAA,eAAAA;AAPf,QAAA,MAAA,EAAA,IAAA,CAAA,MAAA;AAAA,OAAA,EAAA;iBAUMD,OAAQ,CAAA,MAAA;AAAA,UAAAE,kBAAA,CAAA,gEAAA,CAAA;AAVd,UAAAC,UAAA,CAAA,IAAA,CAAA,MAAA,EAAA,SAAA,CAAA;AAAA,SAAA,CAAA;AAAA,QAAA,CAAA,EAAA,CAAA;AAAA;AAAA,OAAA,EAAA,CAAA,EAAA,CAAA,QAAA,CAAA,CAAA,IAAAD,kBAAA,CAAA,MAAA,EAAA,IAAA,CAAA;AAAA,KAAA,CAAA;;;;;;;;;"}
+{"version":3,"file":"scroll-to-top.vue.js","sources":["../../../../../src/x-modules/scroll/components/scroll-to-top.vue"],"sourcesContent":["<template>\n  <component :is=\"animation\">\n    <BaseEventButton\n      v-if=\"isVisible\"\n      class=\"x-scroll-to-top x-button\"\n      data-test=\"scroll-to-top\"\n      aria-label=\"Scroll to top\"\n      :events=\"events\"\n    >\n      <!-- @slot (Required) Button content with a text, an icon or both -->\n      <slot />\n    </BaseEventButton>\n  </component>\n</template>\n\n<script lang=\"ts\">\nimport type { XEventsTypes } from '../../../wiring'\nimport { computed, defineComponent } from 'vue'\nimport { BaseEventButton, NoAnimation } from '../../../components'\nimport { useState } from '../../../composables'\nimport { AnimationProp } from '../../../types'\nimport { scrollXModule } from '../x-module'\nimport { MainScrollId } from './scroll.const'\n\n/**\n * The `ScrollToTop` component is a button that the user can click to make a container scroll\n * up to its initial position.\n *\n * @public\n */\nexport default defineComponent({\n  name: 'ScrollToTop',\n  xModule: scrollXModule.name,\n  components: { BaseEventButton },\n  props: {\n    /**\n     * Animation to use for showing/hiding the button.\n     *\n     * @public\n     */\n    animation: {\n      type: AnimationProp,\n      default: () => NoAnimation,\n    },\n    /**\n     * Threshold in pixels from the top to show the button.\n     *\n     * @public\n     */\n    thresholdPx: Number,\n    /**\n     * Id of the target scroll component.\n     *\n     * @public\n     */\n    scrollId: {\n      type: String,\n      default: MainScrollId,\n    },\n  },\n  setup(props) {\n    /**\n     * State of all the scroll components in this module.\n     *\n     * @internal\n     */\n    // TODO: Directly retrieve the needed data in this computed property\n    const { data } = useState('scroll')\n\n    /**\n     * The scroll data retrieved for this component.\n     *\n     * @returns The scroll data for this component if a valid {@link ScrollToTop.scrollId} has been\n     * passed. Otherwise it returns `null`.\n     * @internal\n     */\n    const scrollData = computed(() => {\n      return props.scrollId && data.value[props.scrollId]\n        ? data.value[props.scrollId]\n        : {\n            position: 0,\n            direction: 'UP',\n            hasReachedStart: false,\n            hasAlmostReachedEnd: false,\n            hasReachedEnd: false,\n          }\n    })\n\n    /**\n     * Event that will be emitted when the scroll to top is clicked.\n     *\n     * @returns The event to be emitted when the scroll to top is clicked. The id as a payload.\n     * @internal\n     */\n    const events = computed(\n      (): Partial<XEventsTypes> => ({ UserClickedScrollToTop: props.scrollId }),\n    )\n\n    /**\n     * Checks if the thresholdPx prop has been provided and if it is a number.\n     *\n     * @returns If the thresholdPx is a number or not.\n     * @internal\n     */\n    const useThresholdStrategy = computed(() => typeof props.thresholdPx === 'number')\n\n    /**\n     * Checks if the threshold has been reached in case the threshold strategy is in use.\n     *\n     * @returns If the scrollTop is bigger than the thresholdPx.\n     * @internal\n     */\n    const isThresholdReached = computed(\n      () => useThresholdStrategy.value && scrollData.value.position > props.thresholdPx!,\n    )\n\n    /**\n     * Returns if the scroll has almost reached its end or not.\n     *\n     * @returns True if the scroll has almost reached the end and the user is still scrolling down.\n     * @internal\n     */\n    const hasAlmostReachedScrollEnd = computed(\n      () => scrollData.value.hasAlmostReachedEnd && scrollData.value.direction === 'DOWN',\n    )\n\n    /**\n     * Whether if the button is visible or not depending on the strategy being used.\n     *\n     * @returns If the button should be visible or not.\n     * @internal\n     */\n    const isVisible = computed(() =>\n      useThresholdStrategy.value ? isThresholdReached.value : hasAlmostReachedScrollEnd.value,\n    )\n\n    return {\n      events,\n      isVisible,\n    }\n  },\n})\n</script>\n\n<docs lang=\"mdx\">\n## Events\n\nA list of events that the component will emit:\n\n- [`UserClickedScrollToTop`](https://github.com/empathyco/x/blob/main/packages/x-components/src/wiring/events.types.ts):\n  the event is emitted after the user clicks the button. The event payload is the id of the scroll\n  that it going to be scrolled.\n\n## Examples\n\n### Basic example\n\nThe component renders whatever is passed to it in the default slot and scrolls to top the scroll\nwith an id `scrollId`.\n\nIt also receives an optional threshold in pixels. When the threshold is reached from the top, the\ncomponent will be shown once the user scrolls `UP`.\n\nIf this parameter is not provided the button will be visible when the user almost reaches the end of\nthe scroll.\n\n```vue\n<template>\n  <div>\n    <ScrollToTop scroll-id=\"scrollId\" :threshold-px=\"1000\">\n      <span>Scroll to top</span>\n    </ScrollToTop>\n  </div>\n</template>\n\n<script>\nimport { ScrollToTop } from '@empathyco/x-components/scroll'\n\nexport default {\n  name: 'ScrollToTopTest',\n  components: {\n    ScrollToTop,\n  },\n}\n</script>\n```\n</docs>\n"],"names":["_openBlock","_createBlock","_resolveDynamicComponent","_withCtx","_renderSlot","_createCommentVNode"],"mappings":";;;;;;AACE,EAAA,OAAAA,SAAA,EAAA,EAAAC,WAAA,CAWYC,wBAXI,IAAS,CAAA,SAAA,CAAA,EAAA,IAAA,EAAA;AAAA,IAD3B,iBAEI,MASkB;AAAA,MARV,+BADRD,WASkB,CAAA,0BAAA,EAAA;AAAA,QAXtB,GAAA,EAAA,CAAA;AAAA,QAIM,KAAM,EAAA,0BAAA;AAAA,QACN,WAAU,EAAA,eAAA;AAAA,QACV,YAAW,EAAA,eAAA;AAAA,QACV,MAAQ,EAAA,IAAA,CAAA,MAAA;AAAA,OAAA,EAAA;AAPf,QAAA,OAAA,EAAAE,OAAA,CAUM,MAAQ;AAAA,UAARC,UAAQ,CAAA,IAAA,CAAA,MAAA,EAAA,SAAA,CAAA;AAAA,SAAA,CAAA;AAVd,QAAA,CAAA,EAAA,CAAA;AAAA;AAAA,OAAA,EAAA,CAAA,EAAA,CAAA,QAAA,CAAA,CAAA,IAAAC,kBAAA,CAAA,MAAA,EAAA,IAAA,CAAA;AAAA,KAAA,CAAA;AAAA,IAAA,CAAA,EAAA,CAAA;AAAA;AAAA,GAAA,CAAA,CAAA;;;;;;"}