uikit 3.14.2-dev.854a8e6b0 → 3.14.2-dev.c7c85455d

package/dist/js/uikit.js

@@ -1,4 +1,4 @@
-/*! UIkit 3.14.2-dev.854a8e6b0 | https://www.getuikit.com | (c) 2014 - 2022 YOOtheme | MIT License */
+/*! UIkit 3.14.2-dev.c7c85455d | https://www.getuikit.com | (c) 2014 - 2022 YOOtheme | MIT License */
 
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
@@ -868,6 +868,7 @@
     }
 
     function transition(element, props, duration, timing) {if (duration === void 0) {duration = 400;}if (timing === void 0) {timing = 'linear';}
+      duration = Math.round(duration);
       return Promise.all(
       toNodes(element).map(
       (element) =>
@@ -1886,7 +1887,7 @@
       return clamp((scrollTop - start) / (end - start));
     }
 
-    function scrollParents(element, overflowRe, scrollable) {if (overflowRe === void 0) {overflowRe = /auto|scroll|hidden/;}if (scrollable === void 0) {scrollable = false;}
+    function scrollParents(element, overflowRe, scrollable) {if (overflowRe === void 0) {overflowRe = /auto|scroll|hidden|clip/;}if (scrollable === void 0) {scrollable = false;}
       const scrollEl = scrollingElement(element);
 
       let ancestors = parents(element).reverse();
@@ -2949,7 +2950,7 @@
     UIkit.data = '__uikit__';
     UIkit.prefix = 'uk-';
     UIkit.options = {};
-    UIkit.version = '3.14.2-dev.854a8e6b0';
+    UIkit.version = '3.14.2-dev.c7c85455d';
 
     globalAPI(UIkit);
     hooksAPI(UIkit);
@@ -3058,7 +3059,7 @@
 
         initProps: {
           overflow: '',
-          height: '',
+          maxHeight: '',
           paddingTop: '',
           paddingBottom: '',
           marginTop: '',
@@ -3068,7 +3069,7 @@
 
         hideProps: {
           overflow: 'hidden',
-          height: 0,
+          maxHeight: 0,
           paddingTop: 0,
           paddingBottom: 0,
           marginTop: 0,
@@ -3083,7 +3084,7 @@
         },
 
         hasTransition(_ref2) {let { animation } = _ref2;
-          return this.hasAnimation && animation[0] === true;
+          return startsWith(animation[0], 'slide');
         } },
 
 
@@ -3098,18 +3099,13 @@
               return Promise.reject();
             }
 
-            if (!animate) {
-              Animation.cancel(el);
-              Transition.cancel(el);
-            }
-
             const promise = (
             isFunction(animate) ?
             animate :
             animate === false || !this.hasAnimation ?
-            this._toggle :
+            toggleInstant(this) :
             this.hasTransition ?
-            toggleHeight(this) :
+            toggleTransition(this) :
             toggleAnimation(this))(
             el, show);
 
@@ -3173,7 +3169,25 @@
 
 
 
-    function toggleHeight(_ref3)
+    function toggleInstant(_ref3) {let { _toggle } = _ref3;
+      return (el, show) => {
+        Animation.cancel(el);
+        Transition.cancel(el);
+        return _toggle(el, show);
+      };
+    }
+
+    function toggleTransition(cmp) {
+      switch (cmp.animation[0]) {
+        case 'slide-left':
+          return slideHorizontal(cmp);
+        case 'slide-right':
+          return slideHorizontal(cmp, true);}
+
+      return slide$1(cmp);
+    }
+
+    function slide$1(_ref4)
 
 
 
@@ -3181,14 +3195,17 @@
 
 
 
-    {let { isToggled, duration, velocity, initProps, hideProps, transition, _toggle } = _ref3;
+    {let { isToggled, duration, velocity, initProps, hideProps, transition, _toggle } = _ref4;
       return (el, show) => {
         const inProgress = Transition.inProgress(el);
-        const inner = el.hasChildNodes() ?
+        const inner =
+        !inProgress && el.hasChildNodes() ?
         toFloat(css(el.firstElementChild, 'marginTop')) +
         toFloat(css(el.lastElementChild, 'marginBottom')) :
         0;
-        const currentHeight = isVisible(el) ? height(el) + (inProgress ? 0 : inner) : 0;
+        const currentHeight = isVisible(el) ? toFloat(css(el, 'height')) + inner : 0;
+
+        const props = inProgress ? css(el, Object.keys(initProps)) : show ? hideProps : initProps;
 
         Transition.cancel(el);
 
@@ -3196,34 +3213,97 @@
           _toggle(el, true);
         }
 
-        height(el, '');
+        css(el, 'maxHeight', '');
 
         // Update child components first
         fastdom.flush();
 
-        const endHeight = height(el) + (inProgress ? 0 : inner);
-        duration = velocity * el.offsetHeight + duration;
+        const endHeight = toFloat(css(el, 'height')) + inner;
+        duration = velocity * endHeight + duration;
 
-        height(el, currentHeight);
+        css(el, { ...props, maxHeight: currentHeight });
 
         return (
         show ?
         Transition.start(
         el,
-        { ...initProps, overflow: 'hidden', height: endHeight },
-        Math.round(duration * (1 - currentHeight / endHeight)),
+        { ...initProps, overflow: 'hidden', maxHeight: endHeight },
+        duration * (1 - currentHeight / endHeight),
         transition) :
 
         Transition.start(
         el,
         hideProps,
-        Math.round(duration * (currentHeight / endHeight)),
+        duration * (currentHeight / endHeight),
         transition).
         then(() => _toggle(el, false))).
         then(() => css(el, initProps));
       };
     }
 
+    function slideHorizontal(_ref5, right) {let { isToggled, duration, velocity, transition, _toggle } = _ref5;
+      return (el, show) => {
+        const visible = isVisible(el);
+        const marginLeft = toFloat(css(el, 'marginLeft'));
+
+        Transition.cancel(el);
+
+        const [scrollElement] = scrollParents(el);
+        css(scrollElement, 'overflowX', 'hidden');
+
+        if (!isToggled(el)) {
+          _toggle(el, true);
+        }
+
+        const width = toFloat(css(el, 'width'));
+        duration = velocity * width + duration;
+
+        const percent = visible ? (width + marginLeft * (right ? -1 : 1)) / width * 100 : 0;
+        const offsetEl = offset(el);
+        const useClipPath = right ?
+        offsetEl.right < scrollElement.clientWidth :
+        Math.round(offsetEl.left) > 0;
+
+        css(el, {
+          clipPath: useClipPath ?
+          right ? "polygon(0 0," +
+          percent + "% 0," + percent + "% 100%,0 100%)" : "polygon(" + (
+          100 - percent) + "% 0,100% 0,100% 100%," + (100 - percent) + "% 100%)" :
+          '',
+          marginLeft: (100 - percent) * (right ? 1 : -1) / 100 * width });
+
+
+        return (
+        show ?
+        Transition.start(
+        el,
+        {
+          clipPath: useClipPath ? "polygon(0 0,100% 0,100% 100%,0 100%)" : '',
+          marginLeft: 0 },
+
+        duration * (1 - percent / 100),
+        transition) :
+
+        Transition.start(
+        el,
+        {
+          clipPath: useClipPath ?
+          right ? "polygon(0 0,0 0,0 100%,0 100%)" : "polygon(100% 0,100% 0,100% 100%,100% 100%)" :
+
+
+          '',
+          marginLeft: (right ? 1 : -1) * width },
+
+        duration * (percent / 100),
+        transition).
+        then(() => _toggle(el, false))).
+        then(() => {
+          css(scrollElement, 'overflowX', '');
+          css(el, { clipPath: '', marginLeft: '' });
+        });
+      };
+    }
+
     function toggleAnimation(cmp) {
       return (el, show) => {
         Animation.cancel(el);
@@ -3257,7 +3337,7 @@
       data: {
         targets: '> *',
         active: false,
-        animation: [true],
+        animation: ['slide'],
         collapsible: true,
         multiple: false,
         clsOpen: 'uk-open',
@@ -3367,7 +3447,7 @@
               }
 
               hide(content, false);
-              await toggleHeight(this)(el._wrapper, show);
+              await slide$1(this)(el._wrapper, show);
               hide(content, !show);
 
               delete el._wrapper;
@@ -3401,7 +3481,7 @@
 
 
       data: {
-        animation: [true],
+        animation: ['slide'],
         selClose: '.uk-alert-close',
         duration: 150,
         hideProps: { opacity: 0, ...Togglable.data.hideProps } },
@@ -3587,33 +3667,17 @@
 
       connected() {
         this.pos = this.$props.pos.split('-').concat('center').slice(0, 2);
-        this.axis = includes(['top', 'bottom'], this.pos[0]) ? 'y' : 'x';
+        [this.dir, this.align] = this.pos;
+        this.axis = includes(['top', 'bottom'], this.dir) ? 'y' : 'x';
       },
 
       methods: {
         positionAt(element, target, boundary) {
-          const [dir, align] = this.pos;
-
-          const mainAxisOffset =
-          toPx(
-          this.offset === false ? getCssVar('position-offset', element) : this.offset,
-          this.axis === 'x' ? 'width' : 'height',
-          element) * (
-          includes(['left', 'top'], dir) ? -1 : 1);
-
-          const crossAxisOffset = includes(['center', 'justify'], align) ?
-          0 :
-          toPx(
-          getCssVar('position-shift-offset', element),
-          this.axis === 'y' ? 'width' : 'height',
-          element) * (
-          includes(['left', 'top'], align) ? 1 : -1);
-
-          let offset = [mainAxisOffset, crossAxisOffset];
+          let offset = [this.getPositionOffset(element), this.getShiftOffset(element)];
 
           const attach = {
-            element: [flipPosition(dir), align],
-            target: [dir, align] };
+            element: [flipPosition(this.dir), this.align],
+            target: [this.dir, this.align] };
 
 
           if (this.axis === 'y') {
@@ -3623,13 +3687,41 @@
             offset = offset.reverse();
           }
 
+          // Ensure none positioned element does not generate scrollbars
+          const elDim = dimensions$1(element);
+          css(element, { top: -elDim.height, left: -elDim.width });
+
           positionAt(element, target, {
             attach,
             offset,
             boundary,
             flip: this.flip,
-            viewportOffset: toPx(getCssVar('position-viewport-offset', element)) });
+            viewportOffset: this.getViewportOffset(element) });
 
+        },
+
+        getPositionOffset(element) {
+          return (
+            toPx(
+            this.offset === false ? getCssVar('position-offset', element) : this.offset,
+            this.axis === 'x' ? 'width' : 'height',
+            element) * (
+            includes(['left', 'top'], this.dir) ? -1 : 1));
+
+        },
+
+        getShiftOffset(element) {
+          return includes(['center', 'justify', 'stretch'], this.align) ?
+          0 :
+          toPx(
+          getCssVar('position-shift-offset', element),
+          this.axis === 'y' ? 'width' : 'height',
+          element) * (
+          includes(['left', 'top'], this.align) ? 1 : -1);
+        },
+
+        getViewportOffset(element) {
+          return toPx(getCssVar('position-viewport-offset', element));
         } } };
 
     let active$1;
@@ -3647,7 +3739,8 @@
         delayShow: Number,
         delayHide: Number,
         display: String,
-        clsDrop: String },
+        clsDrop: String,
+        animateOut: Boolean },
 
 
       data: {
@@ -3661,7 +3754,8 @@
         clsDrop: false,
         animation: ['uk-animation-fade'],
         cls: 'uk-open',
-        container: false },
+        container: false,
+        animateOut: false },
 
 
       created() {
@@ -3849,7 +3943,7 @@
             }
           }),
 
-          ...(this.display === 'static' ?
+          ...(this.display === 'static' && this.align !== 'stretch' ?
           [] :
           (() => {
             const handler = () => this.$emit();
@@ -3910,7 +4004,7 @@
       methods: {
         show(target, delay) {if (target === void 0) {target = this.target;}if (delay === void 0) {delay = true;}
           if (this.isToggled() && target && this.target && target !== this.target) {
-            this.hide(false);
+            this.hide(false, false);
           }
 
           this.target = target;
@@ -3930,7 +4024,7 @@
             let prev;
             while (active$1 && prev !== active$1 && !within(this.$el, active$1.$el)) {
               prev = active$1;
-              active$1.hide(false);
+              active$1.hide(false, false);
             }
           }
 
@@ -3944,8 +4038,8 @@
 
         },
 
-        hide(delay) {if (delay === void 0) {delay = true;}
-          const hide = () => this.toggleElement(this.$el, false, false);
+        hide(delay, animate) {if (delay === void 0) {delay = true;}if (animate === void 0) {animate = true;}
+          const hide = () => this.toggleElement(this.$el, false, this.animateOut && animate);
 
           this.clearTimers();
 
@@ -3977,28 +4071,51 @@
         position() {
           removeClass(this.$el, this.clsDrop + "-stack");
           toggleClass(this.$el, this.clsDrop + "-boundary", this.boundaryAlign);
+          toggleClass(this.$el, this.clsDrop + "-stretch", this.align === 'stretch');
 
           const boundary = query(this.boundary, this.$el);
-          const scrollParentOffset = offset(
-          scrollParents(boundary && this.boundaryAlign ? boundary : this.$el)[0]);
+          const target = boundary && this.boundaryAlign ? boundary : this.target;
+          const [scrollParent] = scrollParents(
+          boundary && this.boundaryAlign ? boundary : this.$el);
 
+          const scrollParentOffset = offset(scrollParent);
           const boundaryOffset = boundary ? offset(boundary) : scrollParentOffset;
+          const viewportOffset = this.getViewportOffset(this.$el);
 
           css(this.$el, 'maxWidth', '');
-          const maxWidth =
-          scrollParentOffset.width -
-          2 * toPx(getCssVar('position-viewport-offset', this.$el));
+          const maxWidth = scrollParentOffset.width - 2 * viewportOffset;
 
-          if (this.pos[1] === 'justify') {
+          if (this.align === 'justify') {
             const prop = this.axis === 'y' ? 'width' : 'height';
             css(
             this.$el,
             prop,
             Math.min(
             (boundary ? boundaryOffset : offset(this.target))[prop],
-            scrollParentOffset[prop] -
-            2 * toPx(getCssVar('position-viewport-offset', this.$el))));
-
+            scrollParentOffset[prop] - 2 * viewportOffset));
+
+
+          } else if (this.align === 'stretch') {
+            this.flip = this.axis === 'y' ? 'x' : 'y';
+            this.display = 'static';
+
+            const viewport = offsetViewport(scrollParent);
+            const targetDim = offset(target);
+            const elOffset = Math.abs(this.getPositionOffset(this.$el)) + viewportOffset;
+
+            css(this.$el, {
+              width:
+              this.axis === 'y' ?
+              viewport.width :
+              (this.dir === 'left' ?
+              targetDim.left - viewport.left :
+              viewport.right - targetDim.right) - elOffset,
+              height:
+              this.axis === 'x' ?
+              viewport.height :
+              (this.dir === 'top' ?
+              targetDim.top - viewport.top :
+              viewport.bottom - targetDim.bottom) - elOffset });
 
           } else if (this.$el.offsetWidth > maxWidth) {
             addClass(this.$el, this.clsDrop + "-stack");
@@ -4006,11 +4123,7 @@
 
           css(this.$el, 'maxWidth', maxWidth);
 
-          this.positionAt(
-          this.$el,
-          boundary && this.boundaryAlign ? boundary : this.target,
-          boundary);
-
+          this.positionAt(this.$el, target, boundary);
         } } };
 
 
@@ -4495,7 +4608,7 @@
 
       resizeTargets() {
         // check for offsetTop change
-        return [this.$el, document.documentElement];
+        return [this.$el, ...scrollParents(this.$el, /auto|scroll/)];
       },
 
       update: {
@@ -4507,21 +4620,25 @@
           let minHeight = '';
           const box = boxModelAdjust(this.$el, 'height', 'content-box');
 
+          const [scrollElement] = scrollParents(this.$el, /auto|scroll/);
+          const { height: viewportHeight } = offsetViewport(scrollElement);
+
           if (this.expand) {
             minHeight = Math.max(
-            height(window) - (
-            dimensions$1(document.documentElement).height -
-            dimensions$1(this.$el).height) -
+            viewportHeight - (
+            dimensions$1(scrollElement).height - dimensions$1(this.$el).height) -
             box,
             0);
 
           } else {
             // on mobile devices (iOS and Android) window.innerHeight !== 100vh
-            minHeight = 'calc(100vh';
+            minHeight = "calc(" + (
+            document.scrollingElement === scrollElement ? '100vh' : viewportHeight + "px");
+
 
             if (this.offsetTop) {
-              const { top } = offset(this.$el);
-              minHeight += top > 0 && top < height(window) / 2 ? " - " + top + "px" : '';
+              const top = offsetPosition(this.$el)[0] - offsetPosition(scrollElement)[0];
+              minHeight += top > 0 && top < viewportHeight / 2 ? " - " + top + "px" : '';
             }
 
             if (this.offsetBottom === true) {
@@ -5855,8 +5972,8 @@
           return this.dropbar;
         },
 
-        handler(_, _ref9) {let { $el } = _ref9;
-          if (!hasClass($el, this.clsDrop)) {
+        handler(_, _ref9) {let { $el, align } = _ref9;
+          if (!hasClass($el, this.clsDrop) || align === 'stretch') {
             return;
           }
 
@@ -5879,19 +5996,19 @@
           return this.dropbar;
         },
 
-        handler(_, _ref10) {let { $el, pos: [dir] = [] } = _ref10;
-          if (!hasClass($el, this.clsDrop)) {
+        handler(_, _ref10) {let { $el, align } = _ref10;
+          if (!hasClass($el, this.clsDrop) || align === 'stretch') {
             return;
           }
 
-          if (dir === 'bottom') {
-            this.transitionTo(
-            offset($el).bottom -
-            offset(this.dropbar).top +
-            toFloat(css($el, 'marginBottom')),
-            $el);
+          this._observer = observeResize($el, () =>
+          this.transitionTo(
+          offset($el).bottom -
+          offset(this.dropbar).top +
+          toFloat(css($el, 'marginBottom')),
+          $el));
+
 
-          }
         } },
 
 
@@ -5930,11 +6047,13 @@
           return this.dropbar;
         },
 
-        handler(_, _ref12) {let { $el } = _ref12;
-          if (!hasClass($el, this.clsDrop)) {
+        handler(_, _ref12) {let { $el, align } = _ref12;
+          if (!hasClass($el, this.clsDrop) || align === 'stretch') {
             return;
           }
 
+          this._observer.disconnect();
+
           const active = this.getActive();
 
           if (!active || (active == null ? void 0 : active.$el) === $el) {
@@ -5951,28 +6070,27 @@
 
         transitionTo(newHeight, el) {
           const { dropbar } = this;
-          const oldHeight = isVisible(dropbar) ? height(dropbar) : 0;
+          const oldHeight = height(dropbar);
 
           el = oldHeight < newHeight && el;
 
-          css(el, 'clip', "rect(0," + el.offsetWidth + "px," + oldHeight + "px,0)");
+          css(el, 'clipPath', "polygon(0 0,100% 0,100% " + oldHeight + "px,0 " + oldHeight + "px)");
 
           height(dropbar, oldHeight);
 
           Transition.cancel([el, dropbar]);
-          return Promise.all([
+          Promise.all([
           Transition.start(dropbar, { height: newHeight }, this.duration),
           Transition.start(
           el,
-          { clip: "rect(0," + el.offsetWidth + "px," + newHeight + "px,0)" },
+          {
+            clipPath: "polygon(0 0,100% 0,100% " + newHeight + "px,0 " + newHeight + "px)" },
+
           this.duration)]).
 
 
           catch(noop).
-          then(() => {
-            css(el, { clip: '' });
-            this.$update(dropbar);
-          });
+          then(() => css(el, { clipPath: '' }));
         },
 
         getDropdown(el) {
@@ -6538,6 +6656,10 @@
         toggle(el, inview) {
           const state = this._data.elements.get(el);
 
+          if (!state) {
+            return;
+          }
+
           state.off == null ? void 0 : state.off();
 
           css(el, 'visibility', !inview && this.hidden ? 'hidden' : '');
@@ -7273,6 +7395,8 @@
         },
 
         handler(e) {
+          this._preventClick = null;
+
           if (!isTouch(e) || this._showState) {
             return;
           }
@@ -7359,6 +7483,7 @@
         handler(e) {
           let link;
           if (
+          this._preventClick ||
           closest(e.target, 'a[href="#"], a[href=""]') ||
           (link = closest(e.target, 'a[href]')) && (
           attr(this.$el, 'aria-expanded') !== 'true' ||
@@ -7367,15 +7492,9 @@
             e.preventDefault();
           }
 
-          if (this._preventClick) {
-            return this._preventClick = null;
-          }
-
-          if (!includes(this.mode, 'click')) {
-            return;
+          if (!this._preventClick && includes(this.mode, 'click')) {
+            this.toggle();
           }
-
-          this.toggle();
         } },
 
 
@@ -9363,12 +9482,17 @@
 
       computed: {
         props(properties, $el) {
-          return keys(props).reduce((result, prop) => {
-            if (!isUndefined(properties[prop])) {
-              result[prop] = props[prop](prop, $el, properties[prop].slice());
+          const stops = {};
+          for (const prop in properties) {
+            if (prop in props && !isUndefined(properties[prop])) {
+              stops[prop] = properties[prop].slice();
             }
-            return result;
-          }, {});
+          }
+          const result = {};
+          for (const prop in stops) {
+            result[prop] = props[prop](prop, $el, stops[prop], stops);
+          }
+          return result;
         } },
 
 
@@ -9497,58 +9621,66 @@
       };
     }
 
-    function backgroundFn(prop, el, stops) {
+    function backgroundFn(prop, el, stops, props) {
       if (stops.length === 1) {
         stops.unshift(0);
       }
 
-      prop = prop.substr(-1);
-      const attr = prop === 'y' ? 'height' : 'width';
-      stops = parseStops(stops, (stop) => toPx(stop, attr, el));
+      const attr = prop === 'bgy' ? 'height' : 'width';
+      props[prop] = parseStops(stops, (stop) => toPx(stop, attr, el));
 
-      const bgPos = getCssValue(el, "background-position-" + prop, '');
+      const bgProps = ['bgx', 'bgy'].filter((prop) => prop in props);
+      if (bgProps.length === 2 && prop === 'bgx') {
+        return noop;
+      }
 
-      return getCssValue(el, 'backgroundSize', '') === 'cover' ?
-      backgroundCoverFn(prop, el, stops, bgPos, attr) :
-      setBackgroundPosFn(prop, stops, bgPos);
+      if (getCssValue(el, 'backgroundSize', '') === 'cover') {
+        return backgroundCoverFn(prop, el, stops, props);
+      }
+
+      const positions = {};
+      for (const prop of bgProps) {
+        positions[prop] = getBackgroundPos(el, prop);
+      }
+
+      return setBackgroundPosFn(bgProps, props, positions);
     }
 
-    function backgroundCoverFn(prop, el, stops, bgPos, attr) {
+    function backgroundCoverFn(prop, el, stops, props) {
       const dimImage = getBackgroundImageDimensions(el);
 
       if (!dimImage.width) {
         return noop;
       }
 
-      const values = stops.map((_ref2) => {let [value] = _ref2;return value;});
-      const min = Math.min(...values);
-      const max = Math.max(...values);
-      const down = values.indexOf(min) < values.indexOf(max);
-
-      const diff = max - min;
-      let pos = (down ? -diff : 0) - (down ? min : max);
-
       const dimEl = {
         width: el.offsetWidth,
         height: el.offsetHeight };
 
 
-      const baseDim = Dimensions.cover(dimImage, dimEl);
-      const span = baseDim[attr] - dimEl[attr];
+      const bgProps = ['bgx', 'bgy'].filter((prop) => prop in props);
 
-      if (span < diff) {
-        dimEl[attr] = baseDim[attr] + diff - span;
-      } else if (span > diff) {
-        const posPercentage = dimEl[attr] / toPx(bgPos, attr, el, true);
+      const positions = {};
+      for (const prop of bgProps) {
+        const values = props[prop].map((_ref2) => {let [value] = _ref2;return value;});
+        const min = Math.min(...values);
+        const max = Math.max(...values);
+        const down = values.indexOf(min) < values.indexOf(max);
+        const diff = max - min;
 
-        if (posPercentage) {
-          pos -= (span - diff) / posPercentage;
-        }
+        positions[prop] = (down ? -diff : 0) - (down ? min : max) + "px";
+        dimEl[prop === 'bgy' ? 'height' : 'width'] += diff;
       }
 
       const dim = Dimensions.cover(dimImage, dimEl);
 
-      const fn = setBackgroundPosFn(prop, stops, pos + "px");
+      for (const prop of bgProps) {
+        const attr = prop === 'bgy' ? 'height' : 'width';
+        const overflow = dim[attr] - dimEl[attr];
+        positions[prop] = "max(" + getBackgroundPos(el, prop) + ",-" + overflow + "px) + " + positions[prop];
+      }
+
+      const fn = setBackgroundPosFn(bgProps, positions, props);
       return (css, percent) => {
         fn(css, percent);
         css.backgroundSize = dim.width + "px " + dim.height + "px";
@@ -9556,9 +9688,16 @@
       };
     }
 
-    function setBackgroundPosFn(prop, stops, pos) {
+    function getBackgroundPos(el, prop) {
+      return getCssValue(el, "background-position-" + prop.substr(-1), '');
+    }
+
+    function setBackgroundPosFn(bgProps, positions, props) {
       return function (css, percent) {
-        css["background-position-" + prop] = "calc(" + pos + " + " + getValue(stops, percent) + "px)";
+        for (const prop of bgProps) {
+          const value = getValue(props[prop], percent);
+          css["background-position-" + prop.substr(-1)] = "calc(" + positions[prop] + " + " + value + "px)";
+        }
       };
     }
 
@@ -9744,6 +9883,21 @@
 
 
 
+    /*
+     * Inspired by https://gist.github.com/gre/1650294?permalink_comment_id=3477425#gistcomment-3477425
+     *
+     * linear: 0
+     * easeInSine: 0.5
+     * easeOutSine: -0.5
+     * easeInQuad: 1
+     * easeOutQuad: -1
+     * easeInCubic: 2
+     * easeOutCubic: -2
+     * easeInQuart: 3
+     * easeOutQuart: -3
+     * easeInQuint: 4
+     * easeOutQuint: -4
+     */
     function ease(percent, easing) {
       return easing >= 0 ? Math.pow(percent, easing + 1) : 1 - Math.pow(1 - percent, 1 - easing);
     }