unpoly-rails 2.5.3 → 2.6.0

data/assets/unpoly/unpoly.es5.js

@@ -8,7 +8,7 @@
 @module up
 */
 window.up = {
-    version: '2.5.3'
+    version: '2.6.0'
 };
 
 
@@ -2167,7 +2167,36 @@ up.error = (function () {
         var message = error.message;
         up.emit(window, 'error', { message: message, error: error, log: false });
     }
+    /*-
+    Throws a [JavaScript error](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error)
+    with the given message.
+  
+    The message may contain [substitution marks](https://developer.mozilla.org/en-US/docs/Web/API/console#Using_string_substitutions).
+  
+    ### Examples
+  
+        up.fail('Division by zero')
+        up.fail('Unexpected result %o', result)
+  
+    @function up.fail
+    @param {string} message
+      A message with details about the error.
+  
+      The message can contain [substitution marks](https://developer.mozilla.org/en-US/docs/Web/API/console#Using_string_substitutions)
+      like `%s` or `%o`.
+    @param {Array<string>} vars...
+      A list of variables to replace any substitution marks in the error message.
+    @internal
+    */
+    function fail() {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        throw up.error.failed(args);
+    }
     return {
+        fail: fail,
         failed: failed,
         aborted: aborted,
         invalidSelector: invalidSelector,
@@ -2176,6 +2205,7 @@ up.error = (function () {
         emitGlobal: emitGlobal
     };
 })();
+up.fail = up.error.fail;
 
 
 /***/ }),
@@ -2837,11 +2867,11 @@ up.element = (function () {
       The [text content](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent) of the created element.
     @param {Object} [attrs.content]
       The [inner HTML](https://developer.mozilla.org/en-US/docs/Web/API/Element/innerHTML) of the created element.
-    @param {Object} [attrs.style]
+    @param {Object|string} [attrs.style]
       An object of CSS properties that will be set as the inline style
-      of the created element.
+      of the created element. The given object may use kebab-case or camelCase keys.
   
-      The given object may use kebab-case or camelCase keys.
+      You may also pass a string with semicolon-separated styles.
     @return {Element}
       The created element.
     @stable
@@ -2949,7 +2979,7 @@ up.element = (function () {
       An object of attributes to set on the created element.
     @param {Object} attrs.text
       The [text content](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent) of the created element.
-    @param {Object} attrs.style
+    @param {Object|string} attrs.style
       An object of CSS properties that will be set as the inline style
       of the created element.
   
@@ -3466,11 +3496,16 @@ up.element = (function () {
     @stable
     */
     function setInlineStyle(element, props) {
-        var style = element.style;
-        for (var key in props) {
-            var value = props[key];
-            value = normalizeStyleValueForWrite(key, value);
-            style[key] = value;
+        if (u.isString(props)) {
+            element.setAttribute('style', props);
+        }
+        else {
+            var style = element.style;
+            for (var key in props) {
+                var value = props[key];
+                value = normalizeStyleValueForWrite(key, value);
+                style[key] = value;
+            }
         }
     }
     function normalizeStyleValueForWrite(key, value) {
@@ -4633,8 +4668,16 @@ up.Change.UpdateLayer = /** @class */ (function (_super) {
                                 up.fragment.markAsDestroying(step.oldElement);
                             }, afterInsert: function () {
                                 _this.responseDoc.finalizeElement(step.newElement);
+                                step.keepPlans.forEach(_this.reviveKeepable);
+                                // In the case of [up-keep] descendants, keepable elements are now transferred
+                                // to step.newElement, leaving a clone in their old DOM Position.
+                                // up.hello() is aware of step.keepPlans and will not compile kept elements a second time.
                                 up.hello(step.newElement, step);
                             }, beforeDetach: function () {
+                                // In the case of [up-keep] descendants, keepable elements have been replaced
+                                // with a clone in step.oldElement. However, since that clone was never compiled,
+                                // it does not have destructors registered. Hence we will not clean the clone
+                                // unnecessarily.
                                 up.syntax.clean(step.oldElement, { layer: _this.layer });
                             }, afterDetach: function () {
                                 e.remove(step.oldElement); // clean up jQuery data
@@ -4762,9 +4805,10 @@ up.Change.UpdateLayer = /** @class */ (function (_super) {
         if (step.keep) {
             for (var _i = 0, _a = step.oldElement.querySelectorAll('[up-keep]'); _i < _a.length; _i++) {
                 var keepable = _a[_i];
-                var plan = this.findKeepPlan(__assign(__assign({}, step), { oldElement: keepable, descendantsOnly: true }));
-                if (plan) {
+                var keepPlan = this.findKeepPlan(__assign(__assign({}, step), { oldElement: keepable, descendantsOnly: true }));
+                if (keepPlan) {
                     // plan.oldElement is now keepable
+                    this.hibernateKeepable(keepPlan);
                     // Replace keepable with its clone so it looks good in a transition between
                     // oldElement and newElement. Note that keepable will still point to the same element
                     // after the replacement, which is now detached.
@@ -4772,8 +4816,8 @@ up.Change.UpdateLayer = /** @class */ (function (_super) {
                     e.replace(keepable, keepableClone);
                     // Since we're going to swap the entire oldElement and newElement containers afterwards,
                     // replace the matching element with keepable so it will eventually return to the DOM.
-                    e.replace(plan.newElement, keepable);
-                    keepPlans.push(plan);
+                    e.replace(keepPlan.newElement, keepable);
+                    keepPlans.push(keepPlan);
                 }
             }
         }
@@ -4795,6 +4839,19 @@ up.Change.UpdateLayer = /** @class */ (function (_super) {
             }
         }
     };
+    UpdateLayer.prototype.hibernateKeepable = function (keepPlan) {
+        var viewports = up.viewport.subtree(keepPlan.oldElement);
+        keepPlan.revivers = viewports.map(function (viewport) {
+            var scrollTop = viewport.scrollTop, scrollLeft = viewport.scrollLeft;
+            return function () { return u.assign(viewport, { scrollTop: scrollTop, scrollLeft: scrollLeft }); };
+        });
+    };
+    UpdateLayer.prototype.reviveKeepable = function (keepPlan) {
+        for (var _i = 0, _a = keepPlan.revivers; _i < _a.length; _i++) {
+            var reviver = _a[_i];
+            reviver();
+        }
+    };
     UpdateLayer.prototype.matchPreflight = function () {
         if (this.matchedPreflight) {
             return;
@@ -4966,7 +5023,7 @@ up.Change.CloseLayer = /** @class */ (function (_super) {
         // The close event is emitted on the layer that is about to close.
         return this.layer.emit(this.buildEvent("up:layer:".concat(this.verb)), {
             callback: this.layer.callback("on".concat(u.upperCaseFirst(this.verb))),
-            log: "Will ".concat(this.verb, " ").concat(this.layer)
+            log: ["Will ".concat(this.verb, " ").concat(this.layer, " with value %o"), this.value]
         });
     };
     CloseLayer.prototype.emitClosedEvent = function (formerParent) {
@@ -4984,7 +5041,7 @@ up.Change.CloseLayer = /** @class */ (function (_super) {
             baseLayer: formerParent,
             callback: this.layer.callback("on".concat(verbPastUpperCaseFirst)),
             ensureBubbles: true,
-            log: "".concat(verbPastUpperCaseFirst, " ").concat(this.layer)
+            log: ["".concat(verbPastUpperCaseFirst, " ").concat(this.layer, " with value %o"), this.value]
         });
     };
     CloseLayer.prototype.buildEvent = function (name) {
@@ -6588,6 +6645,117 @@ up.FragmentFocus = /** @class */ (function (_super) {
 /* 33 */
 /***/ (function() {
 
+var e = up.element;
+var u = up.util;
+up.FragmentPolling = /** @class */ (function () {
+    function FragmentPolling(fragment) {
+        this.options = {};
+        this.state = 'initialized';
+        this.setFragment(fragment);
+    }
+    FragmentPolling.forFragment = function (fragment) {
+        return fragment.upPolling || (fragment.upPolling = new this(fragment));
+    };
+    FragmentPolling.prototype.onPollAttributeObserved = function () {
+        this.start();
+    };
+    FragmentPolling.prototype.onFragmentDestroyed = function () {
+        // The element may come back (when it is swapped) or or may not come back (when it is destroyed).
+        // If it does come back, `onPollAttributeObserved()` will restart the polling.
+        this.stop();
+    };
+    FragmentPolling.prototype.start = function () {
+        if (this.state !== 'started') {
+            this.state = 'started';
+            this.scheduleReload();
+        }
+    };
+    FragmentPolling.prototype.stop = function () {
+        if (this.state === 'started') {
+            clearTimeout(this.reloadTimer);
+            this.state = 'stopped';
+        }
+    };
+    FragmentPolling.prototype.forceStart = function (options) {
+        u.assign(this.options, options);
+        this.forceStarted = true;
+        this.start();
+    };
+    FragmentPolling.prototype.forceStop = function () {
+        this.stop();
+        this.forceStarted = false;
+    };
+    FragmentPolling.prototype.scheduleReload = function (delay) {
+        var _this = this;
+        if (delay === void 0) { delay = this.getInterval(); }
+        this.reloadTimer = setTimeout(function () { return _this.reload(); }, delay);
+    };
+    FragmentPolling.prototype.reload = function () {
+        var _this = this;
+        // The setTimeout(doReload) callback might already be scheduled
+        // before the polling stopped.
+        if (this.state !== 'started') {
+            return;
+        }
+        if (up.radio.shouldPoll(this.fragment)) {
+            var reloadOptions = {
+                url: this.options.url,
+                guardEvent: up.event.build('up:fragment:poll', { log: 'Polling fragment' })
+            };
+            u.always(up.reload(this.fragment, reloadOptions), function (result) { return _this.onReloaded(result); });
+        }
+        else {
+            up.puts('[up-poll]', 'Polling is disabled');
+            // Reconsider after 10 seconds at most
+            var reconsiderDisabledDelay = Math.min(10 * 1000, this.getInterval());
+            this.scheduleReload(reconsiderDisabledDelay);
+        }
+    };
+    FragmentPolling.prototype.onReloaded = function (result) {
+        var _a;
+        // Transfer this instance to the new fragment.
+        // We can remove this in case we don't implement forced start/stop.
+        var newFragment = (_a = result === null || result === void 0 ? void 0 : result.fragments) === null || _a === void 0 ? void 0 : _a[0];
+        if (newFragment) {
+            // No need to scheduleReload() in this branch:
+            // (1) Either the new fragment also has an [up-poll] and we have already
+            //     started in #onPollAttributeObserved().
+            // (2) Or we are force-started and we will start in #onFragmentSwapped().
+            this.onFragmentSwapped(newFragment);
+        }
+        else {
+            this.scheduleReload();
+        }
+    };
+    FragmentPolling.prototype.onFragmentSwapped = function (newFragment) {
+        // Transfer this polling to the new instance
+        newFragment.upPolling = this;
+        delete this.fragment.upPolling;
+        this.setFragment(newFragment);
+        if (this.state === 'stopped' && this.forceStarted) {
+            // When polling was started programmatically through up.fragment.startPolling()
+            // we don't require the updated fragment to have an [up-poll] attribute to
+            // continue polling.
+            this.start();
+        }
+    };
+    FragmentPolling.prototype.setFragment = function (newFragment) {
+        var _this = this;
+        this.fragment = newFragment;
+        up.destructor(newFragment, function () { return _this.onFragmentDestroyed(); });
+    };
+    FragmentPolling.prototype.getInterval = function () {
+        var _a, _b;
+        return (_b = (_a = this.options.interval) !== null && _a !== void 0 ? _a : e.numberAttr(this.fragment, 'up-interval')) !== null && _b !== void 0 ? _b : up.radio.config.pollInterval;
+    };
+    return FragmentPolling;
+}());
+
+
+/***/ }),
+/* 34 */
+/***/ (function() {
+
 var __extends = (this && this.__extends) || (function () {
     var extendStatics = function (d, b) {
         extendStatics = Object.setPrototypeOf ||
@@ -6694,7 +6862,7 @@ up.FragmentScrolling = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 34 */
+/* 35 */
 /***/ (function() {
 
 var u = up.util;
@@ -6737,7 +6905,7 @@ up.HTMLWrapper = /** @class */ (function () {
 
 
 /***/ }),
-/* 35 */
+/* 36 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -7499,7 +7667,7 @@ up.Layer = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 36 */
+/* 37 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -7687,12 +7855,6 @@ up.Layer.Overlay = /** @class */ (function (_super) {
             this.createDismissElement(this.getBoxElement());
         }
         if (this.supportsDismissMethod('outside')) {
-            this.unbindParentClicked = this.parent.on('up:click', function (event, element) {
-                // When our origin is clicked again, halt the click event
-                // We achieve this by halting the click event.
-                var originClicked = _this.origin && _this.origin.contains(element);
-                _this.onOutsideClicked(event, originClicked);
-            });
             // If this overlay has its own viewport, a click outside the frame will hit
             // the viewport and not the parent element.
             if (this.viewportElement) {
@@ -7703,6 +7865,18 @@ up.Layer.Overlay = /** @class */ (function (_super) {
                     }
                 });
             }
+            else {
+                // Only bind to the parent if there's not already a viewport.
+                // This prevents issues with other overlay libs appending elements to document.body,
+                // but overlaying this overlay with a huge z-index. Clicking such a foreign overlay
+                // would close this layer, as Unpoly considers it to be on the root layer (our parent).2
+                this.unbindParentClicked = this.parent.on('up:click', function (event, element) {
+                    // When our origin is clicked again, halt the click event
+                    // We achieve this by halting the click event.
+                    var originClicked = _this.origin && _this.origin.contains(element);
+                    _this.onOutsideClicked(event, originClicked);
+                });
+            }
         }
         if (this.supportsDismissMethod('key')) {
             this.unbindEscapePressed = up.event.onEscape(function (event) { return _this.onEscapePressed(event); });
@@ -7725,7 +7899,7 @@ up.Layer.Overlay = /** @class */ (function (_super) {
         if (halt) {
             up.event.halt(event);
         }
-        this.dismiss(':outside');
+        this.dismiss(':outside', { origin: event.target });
     };
     Overlay.prototype.onEscapePressed = function (event) {
         // All overlays listen to the Escape key being pressed, but only the front layer
@@ -7752,7 +7926,7 @@ up.Layer.Overlay = /** @class */ (function (_super) {
             // Since we're defining this handler on up.Overlay, we will not prevent
             // a link from being followed on the root layer.
             up.event.halt(event);
-            var origin = event.target.closest(selector);
+            var origin = e.closest(event.target, selector);
             var value = e.jsonAttr(origin, attribute);
             var closeOptions = { origin: origin };
             var parser = new up.OptionsParser(closeOptions, origin);
@@ -7890,7 +8064,7 @@ up.Layer.Overlay = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 37 */
+/* 38 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -7955,7 +8129,7 @@ up.Layer.OverlayWithTether = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 38 */
+/* 39 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8027,7 +8201,7 @@ up.Layer.OverlayWithViewport = (_a = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 39 */
+/* 40 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8121,7 +8295,7 @@ up.Layer.Root = (_a = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 40 */
+/* 41 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8152,7 +8326,7 @@ up.Layer.Modal = (_a = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 41 */
+/* 42 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8183,7 +8357,7 @@ up.Layer.Popup = (_a = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 42 */
+/* 43 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8214,7 +8388,7 @@ up.Layer.Drawer = (_a = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 43 */
+/* 44 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8245,7 +8419,7 @@ up.Layer.Cover = (_a = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 44 */
+/* 45 */
 /***/ (function() {
 
 var __assign = (this && this.__assign) || function () {
@@ -8370,7 +8544,7 @@ up.LayerLookup = /** @class */ (function () {
 
 
 /***/ }),
-/* 45 */
+/* 46 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8575,7 +8749,7 @@ up.LayerStack = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 46 */
+/* 47 */
 /***/ (function() {
 
 up.LinkFeedbackURLs = /** @class */ (function () {
@@ -8610,7 +8784,7 @@ up.LinkFeedbackURLs = /** @class */ (function () {
 
 
 /***/ }),
-/* 47 */
+/* 48 */
 /***/ (function() {
 
 var u = up.util;
@@ -8691,7 +8865,7 @@ up.LinkPreloader = /** @class */ (function () {
 
 
 /***/ }),
-/* 48 */
+/* 49 */
 /***/ (function() {
 
 var __assign = (this && this.__assign) || function () {
@@ -8944,7 +9118,7 @@ up.MotionController = /** @class */ (function () {
 
 
 /***/ }),
-/* 49 */
+/* 50 */
 /***/ (function() {
 
 var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
@@ -9075,7 +9249,7 @@ up.NonceableCallback = /** @class */ (function () {
 
 
 /***/ }),
-/* 50 */
+/* 51 */
 /***/ (function() {
 
 var __assign = (this && this.__assign) || function () {
@@ -9153,7 +9327,7 @@ up.OptionsParser = /** @class */ (function () {
 
 
 /***/ }),
-/* 51 */
+/* 52 */
 /***/ (function() {
 
 var e = up.element;
@@ -9247,7 +9421,7 @@ up.OverlayFocus = /** @class */ (function () {
 
 
 /***/ }),
-/* 52 */
+/* 53 */
 /***/ (function() {
 
 var u = up.util;
@@ -9844,7 +10018,7 @@ up.Params = /** @class */ (function () {
 
 
 /***/ }),
-/* 53 */
+/* 54 */
 /***/ (function() {
 
 var e = up.element;
@@ -9902,7 +10076,7 @@ up.ProgressBar = /** @class */ (function () {
 
 
 /***/ }),
-/* 54 */
+/* 55 */
 /***/ (function() {
 
 var u = up.util;
@@ -10041,7 +10215,7 @@ up.RenderOptions = (function () {
 
 
 /***/ }),
-/* 55 */
+/* 56 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -10102,7 +10276,7 @@ up.RenderResult = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 56 */
+/* 57 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -10168,8 +10342,18 @@ up.Request = /** @class */ (function (_super) {
         // Normalize a first time to get a normalized cache key.
         _this.normalizeForCaching();
         if (!options.basic) {
-            _this.layer = up.layer.get(_this.layer); // If @layer and @origin is undefined, this will choose the current layer.
-            _this.failLayer = up.layer.get(_this.failLayer || _this.layer);
+            var layerLookupOptions = { origin: _this.origin };
+            // Calling up.layer.get() will give us:
+            //
+            // (1) Resolution of strings like 'current' to an up.Layer instance
+            // (2) Default of origin's layer
+            // (3) Default of up.layer.current
+            //
+            // up.layer.get('new') will return 'new' unchanged, but I'm not sure
+            // if any code actually calls up.request({ ..., layer: 'new' }).
+            // In up.Change.OpenLayer we connect requests to the base layer we're stacking upon.
+            _this.layer = up.layer.get(_this.layer, layerLookupOptions);
+            _this.failLayer = up.layer.get(_this.failLayer || _this.layer, layerLookupOptions);
             _this.context || (_this.context = _this.layer.context || {}); // @layer might be "new", so we default to {}
             _this.failContext || (_this.failContext = _this.failLayer.context || {}); // @failLayer might be "new", so we default to {}
             _this.mode || (_this.mode = _this.layer.mode);
@@ -10724,7 +10908,7 @@ up.Request.tester = function (condition) {
 
 
 /***/ }),
-/* 57 */
+/* 58 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -10791,7 +10975,7 @@ up.Request.Cache = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 58 */
+/* 59 */
 /***/ (function() {
 
 var u = up.util;
@@ -10945,7 +11129,7 @@ up.Request.Queue = /** @class */ (function () {
 
 
 /***/ }),
-/* 59 */
+/* 60 */
 /***/ (function() {
 
 var u = up.util;
@@ -10998,7 +11182,7 @@ up.Request.FormRenderer = /** @class */ (function () {
 
 
 /***/ }),
-/* 60 */
+/* 61 */
 /***/ (function() {
 
 var CONTENT_TYPE_URL_ENCODED = 'application/x-www-form-urlencoded';
@@ -11106,7 +11290,7 @@ up.Request.XHRRenderer = /** @class */ (function () {
 
 
 /***/ }),
-/* 61 */
+/* 62 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -11324,7 +11508,7 @@ up.Response = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 62 */
+/* 63 */
 /***/ (function() {
 
 var u = up.util;
@@ -11433,7 +11617,7 @@ up.ResponseDoc = /** @class */ (function () {
 
 
 /***/ }),
-/* 63 */
+/* 64 */
 /***/ (function() {
 
 var e = up.element;
@@ -11555,7 +11739,7 @@ up.RevealMotion = /** @class */ (function () {
 
 
 /***/ }),
-/* 64 */
+/* 65 */
 /***/ (function() {
 
 var u = up.util;
@@ -11635,7 +11819,7 @@ up.ScrollMotion = /** @class */ (function () {
 
 
 /***/ }),
-/* 65 */
+/* 66 */
 /***/ (function() {
 
 var e = up.element;
@@ -11689,7 +11873,7 @@ up.Selector = /** @class */ (function () {
 
 
 /***/ }),
-/* 66 */
+/* 67 */
 /***/ (function() {
 
 var u = up.util;
@@ -11724,7 +11908,7 @@ up.store.Memory = /** @class */ (function () {
 
 
 /***/ }),
-/* 67 */
+/* 68 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -11812,7 +11996,7 @@ up.store.Session = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 68 */
+/* 69 */
 /***/ (function() {
 
 var u = up.util;
@@ -11974,7 +12158,7 @@ up.Tether = /** @class */ (function () {
 
 
 /***/ }),
-/* 69 */
+/* 70 */
 /***/ (function() {
 
 var u = up.util;
@@ -12068,7 +12252,7 @@ up.URLPattern = /** @class */ (function () {
 
 
 /***/ }),
-/* 70 */
+/* 71 */
 /***/ (function() {
 
 /*-
@@ -12279,7 +12463,7 @@ up.boot = up.framework.boot;
 
 
 /***/ }),
-/* 71 */
+/* 72 */
 /***/ (function() {
 
 /*-
@@ -12872,7 +13056,7 @@ up.emit = up.event.emit;
 
 
 /***/ }),
-/* 72 */
+/* 73 */
 /***/ (function() {
 
 /*-
@@ -13671,7 +13855,7 @@ up.protocol = (function () {
 
 
 /***/ }),
-/* 73 */
+/* 74 */
 /***/ (function() {
 
 var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
@@ -13850,37 +14034,6 @@ up.log = (function () {
         setEnabled(false);
     }
     /*-
-    Throws a [JavaScript error](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error)
-    with the given message.
-  
-    The message will also be printed to the error log. Also a notification will be shown at the bottom of the screen.
-  
-    The message may contain [substitution marks](https://developer.mozilla.org/en-US/docs/Web/API/console#Using_string_substitutions).
-  
-    ### Examples
-  
-        up.fail('Division by zero')
-        up.fail('Unexpected result %o', result)
-  
-    @function up.fail
-    @param {string} message
-      A message with details about the error.
-  
-      The message can contain [substitution marks](https://developer.mozilla.org/en-US/docs/Web/API/console#Using_string_substitutions)
-      like `%s` or `%o`.
-    @param {Array<string>} vars...
-      A list of variables to replace any substitution marks in the error message.
-    @experimental
-    */
-    function fail() {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        printToError.apply(void 0, __spreadArray(['error'], args, false));
-        throw up.error.failed(args);
-    }
-    /*-
     Registers an empty rejection handler in case the given promise
     rejects with an AbortError or a failed up.Response.
   
@@ -13916,18 +14069,16 @@ up.log = (function () {
         config: config,
         enable: enable,
         disable: disable,
-        fail: fail,
         muteUncriticalRejection: muteUncriticalRejection,
         isEnabled: function () { return config.enabled; },
     };
 })();
 up.puts = up.log.puts;
 up.warn = up.log.warn;
-up.fail = up.log.fail;
 
 
 /***/ }),
-/* 74 */
+/* 75 */
 /***/ (function() {
 
 /*-
@@ -14253,7 +14404,6 @@ up.syntax = (function () {
             isDefault: up.framework.evaling,
             priority: 0,
             batch: false,
-            keep: false,
             jQuery: false
         });
         return u.assign(callback, options);
@@ -14449,7 +14599,7 @@ up.data = up.syntax.data;
 
 
 /***/ }),
-/* 75 */
+/* 76 */
 /***/ (function() {
 
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
@@ -14766,9 +14916,6 @@ up.history = (function () {
         return historyLayer.emit.apply(historyLayer, args);
     }
     function register() {
-        // Supported by all browser except IE:
-        // https://developer.mozilla.org/en-US/docs/Web/API/History/scrollRestoration
-        window.history.scrollRestoration = 'manual';
         window.addEventListener('popstate', onPop);
         // Unpoly replaces the initial page state so it can later restore it when the user
         // goes back to that initial URL. However, if the initial request was a POST,
@@ -14843,7 +14990,7 @@ up.history = (function () {
 
 
 /***/ }),
-/* 76 */
+/* 77 */
 /***/ (function(__unused_webpack_module, __unused_webpack_exports, __webpack_require__) {
 
 var __assign = (this && this.__assign) || function () {
@@ -14857,7 +15004,7 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
-__webpack_require__(77);
+__webpack_require__(78);
 var u = up.util;
 var e = up.element;
 /*-
@@ -15715,7 +15862,7 @@ up.fragment = (function () {
         var keepPlans = options.keepPlans || [];
         var skip = keepPlans.map(function (plan) {
             emitFragmentKept(plan);
-            return plan.oldElement;
+            return plan.oldElement; // the kept element
         });
         up.syntax.compile(element, { skip: skip, layer: options.layer });
         emitFragmentInserted(element, options);
@@ -16696,13 +16843,13 @@ u.delegate(up, 'context', function () { return up.layer.current; });
 
 
 /***/ }),
-/* 77 */
+/* 78 */
 /***/ (function() {
 
 
 
 /***/ }),
-/* 78 */
+/* 79 */
 /***/ (function(__unused_webpack_module, __unused_webpack_exports, __webpack_require__) {
 
 var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
@@ -16714,7 +16861,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     }
     return to.concat(ar || Array.prototype.slice.call(from));
 };
-__webpack_require__(79);
+__webpack_require__(80);
 /*-
 Scrolling viewports
 ===================
@@ -16828,8 +16975,8 @@ up.viewport = (function () {
       The container element to scroll.
     @param {number} scrollPos
       The absolute number of pixels to set the scroll position to.
-    @param {string}[options.behavior='auto']
-      When set to `'auto'`, this will immediately scroll to the new position.
+    @param {string}[options.behavior='instant']
+      When set to `'instant'`, this will immediately scroll to the new position.
   
       When set to `'smooth'`, this will scroll smoothly to the new position.
     @param {number}[options.speed]
@@ -16902,8 +17049,8 @@ up.viewport = (function () {
   
       Defaults to `up.viewport.config.revealTop`.
   
-    @param {string}[options.behavior='auto']
-      When set to `'auto'`, this will immediately scroll to the new position.
+    @param {string}[options.behavior='instant']
+      When set to `'instant'`, this will immediately scroll to the new position.
   
       When set to `'smooth'`, this will scroll smoothly to the new position.
   
@@ -17009,7 +17156,7 @@ up.viewport = (function () {
     /*-
     [Reveals](/up.reveal) an element matching the given `#hash` anchor.
   
-    Other than the default behavior found in browsers, `up.revealHash` works with
+    Other than the default behavior found in browsers, `up.revealHash()` works with
     [multiple viewports](/up-viewport) and honors [fixed elements](/up-fixed-top) obstructing the user's
     view of the viewport.
   
@@ -17593,13 +17740,13 @@ up.reveal = up.viewport.reveal;
 
 
 /***/ }),
-/* 79 */
+/* 80 */
 /***/ (function() {
 
 
 
 /***/ }),
-/* 80 */
+/* 81 */
 /***/ (function() {
 
 var __assign = (this && this.__assign) || function () {
@@ -18353,10 +18500,10 @@ up.animate = up.motion.animate;
 
 
 /***/ }),
-/* 81 */
+/* 82 */
 /***/ (function(__unused_webpack_module, __unused_webpack_exports, __webpack_require__) {
 
-__webpack_require__(82);
+__webpack_require__(83);
 var u = up.util;
 /*-
 Network requests
@@ -19249,13 +19396,13 @@ up.cache = up.network.cache;
 
 
 /***/ }),
-/* 82 */
+/* 83 */
 /***/ (function() {
 
 
 
 /***/ }),
-/* 83 */
+/* 84 */
 /***/ (function(__unused_webpack_module, __unused_webpack_exports, __webpack_require__) {
 
 var __assign = (this && this.__assign) || function () {
@@ -19314,7 +19461,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     }
     return to.concat(ar || Array.prototype.slice.call(from));
 };
-__webpack_require__(84);
+__webpack_require__(85);
 var u = up.util;
 var e = up.element;
 /*-
@@ -19456,6 +19603,11 @@ up.layer = (function () {
       If set to `true`, the overlay will always render history.
       If set to `false`, the overlay will never render history.
   
+    @param {string} [config.overlay.class]
+      An HTML class for the overlay's container element.
+  
+      See [overlay classes](/customizing-overlays#overlay-classes).
+  
     @param {object} config.modal
       Defaults for [modal overlays](/layer-terminology).
   
@@ -20323,6 +20475,8 @@ up.layer = (function () {
     @event up:layer:accept
     @param {up.Layer} event.layer
       The layer that is about to close.
+    @param {Element} [event.value]
+      The overlay's [acceptance value](/closing-overlays#overlay-result-values).
     @param {Element} [event.origin]
       The element that is causing the layer to close.
     @param event.preventDefault()
@@ -20339,6 +20493,8 @@ up.layer = (function () {
     @event up:layer:accepted
     @param {up.Layer} event.layer
       The layer that was closed.
+    @param {Element} [event.value]
+      The overlay's [acceptance value](/closing-overlays#overlay-result-values).
     @param {Element} [event.origin]
       The element that has caused the layer to close.
     @stable
@@ -20362,6 +20518,8 @@ up.layer = (function () {
     @event up:layer:dismiss
     @param {up.Layer} event.layer
       The layer that is about to close.
+    @param {Element} [event.value]
+      The overlay's [dismissal value](/closing-overlays#overlay-result-values).
     @param {Element} [event.origin]
       The element that is causing the layer to close.
     @param event.preventDefault()
@@ -20378,6 +20536,8 @@ up.layer = (function () {
     @event up:layer:dismissed
     @param {up.Layer} event.layer
       The layer that was closed.
+    @param {Element} [event.value]
+      The overlay's [dismissal value](/closing-overlays#overlay-result-values).
     @param {Element} [event.origin]
       The element that has caused the layer to close.
     @stable
@@ -20583,13 +20743,13 @@ up.layer = (function () {
 
 
 /***/ }),
-/* 84 */
+/* 85 */
 /***/ (function() {
 
 
 
 /***/ }),
-/* 85 */
+/* 86 */
 /***/ (function(__unused_webpack_module, __unused_webpack_exports, __webpack_require__) {
 
 var __assign = (this && this.__assign) || function () {
@@ -20612,7 +20772,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     }
     return to.concat(ar || Array.prototype.slice.call(from));
 };
-__webpack_require__(86);
+__webpack_require__(87);
 /*-
 Linking to fragments
 ====================
@@ -21591,12 +21751,6 @@ up.link = (function () {
       A JSON object that will be merged into the [context](/context)
       of the current layer once the fragment is rendered.
   
-    @param [up-keep='true']
-      Whether [`[up-keep]`](/up-keep) elements will be preserved in the updated fragment.
-  
-    @param [up-hungry='true']
-      Whether [`[up-hungry]`](/up-hungry) elements outside the updated fragment will also be updated.
-  
     @param [up-scroll='auto']
       How to scroll after the new fragment was rendered.
   
@@ -21771,13 +21925,13 @@ up.follow = up.link.follow;
 
 
 /***/ }),
-/* 86 */
+/* 87 */
 /***/ (function() {
 
 
 
 /***/ }),
-/* 87 */
+/* 88 */
 /***/ (function() {
 
 var __assign = (this && this.__assign) || function () {
@@ -21827,7 +21981,7 @@ up.form = (function () {
       up.form.config.submitSelectors.push('form')
       ```
   
-      Individual forms may opt out with an `[up-submit=follow]` attribute.
+      Individual forms may opt out with an `[up-submit=false]` attribute.
       You may configure additional exceptions in `config.noSubmitSelectors`.
   
     @param {Array<string>} [config.noSubmitSelectors]
@@ -23090,7 +23244,7 @@ up.validate = up.form.validate;
 
 
 /***/ }),
-/* 88 */
+/* 89 */
 /***/ (function() {
 
 /*-
@@ -23527,7 +23681,7 @@ up.feedback = (function () {
 
 
 /***/ }),
-/* 89 */
+/* 90 */
 /***/ (function() {
 
 /*-
@@ -23543,7 +23697,6 @@ This package contains functionality to passively receive updates from the server
 */
 up.radio = (function () {
     var u = up.util;
-    var e = up.element;
     /*-
     Configures defaults for passive updates.
   
@@ -23561,7 +23714,7 @@ up.radio = (function () {
     @param {boolean|string|Function(Element)} [config.pollEnabled=true]
       Whether Unpoly will follow instructions to poll fragments, like the `[up-poll]` attribute.
   
-      When set to `'auto'` Unpoly will poll if one of the following applies:
+      When set to `'auto'` Unpoly will skip polling updates while one of the following applies:
   
       - The browser tab is in the foreground
       - The fragment's layer is the [frontmost layer](/up.layer.front).
@@ -23573,6 +23726,9 @@ up.radio = (function () {
   
       You may also pass a function that accepts the polling fragment and returns `true`, `false` or `'auto'`.
   
+      When an update is skipped due to polling being disabled,
+      Unpoly will try to poll again after the configured interval.
+  
     @stable
     */
     var config = new up.Config(function () { return ({
@@ -23606,65 +23762,33 @@ up.radio = (function () {
     /*-
     Starts [polling](/up-poll) the given element.
   
+    The given element does not need an `[up-poll]` attribute.
+  
     @function up.radio.startPolling
-    @param {Element|jQuery|string} fragment
+    @param {Element} fragment
       The fragment to reload periodically.
     @param {number} options.interval
       The reload interval in milliseconds.
   
       Defaults to `up.radio.config.pollInterval`.
+    @param {string} options.url
+      Defaults to the element's closest `[up-source]` attribute.
     @stable
     */
     function startPolling(fragment, options) {
-        var _a, _b;
         if (options === void 0) { options = {}; }
-        var interval = (_b = ((_a = options.interval) !== null && _a !== void 0 ? _a : e.numberAttr(fragment, 'up-interval'))) !== null && _b !== void 0 ? _b : config.pollInterval;
-        var stopped = false;
-        var lastRequest = null;
-        options.onQueued = function (request) { return lastRequest = request; };
-        function doReload() {
-            // The setTimeout(doReload) callback might already be scheduled
-            // before the polling stopped.
-            if (stopped) {
-                return;
-            }
-            if (shouldPoll(fragment)) {
-                u.always(up.reload(fragment, options), doSchedule);
-            }
-            else {
-                up.puts('[up-poll]', 'Polling is disabled');
-                // Reconsider after 10 seconds at most
-                doSchedule(Math.min(10 * 1000, interval));
-            }
-        }
-        function doSchedule(delay) {
-            if (delay === void 0) { delay = interval; }
-            // The up.reload().then(doSchedule) callback might already be
-            // registered before the polling stopped.
-            if (stopped) {
-                return;
-            }
-            setTimeout(doReload, delay);
-        }
-        function destructor() {
-            stopped = true; // Don't execute already-scheduled callbacks
-            lastRequest === null || lastRequest === void 0 ? void 0 : lastRequest.abort(); // Abort any pending request
-        }
-        // up.radio.stopPolling() will emit up:poll:stop to signal cancelation.
-        up.on(fragment, 'up:poll:stop', destructor);
-        doSchedule();
-        return destructor;
+        up.FragmentPolling.forFragment(fragment).forceStart(options);
     }
     /*-
     Stops [polling](/up-poll) the given element.
   
     @function up.radio.stopPolling
-    @param {Element|jQuery|string} fragment
+    @param {Element} fragment
       The fragment to stop reloading.
     @stable
     */
     function stopPolling(element) {
-        up.emit(element, 'up:poll:stop');
+        up.FragmentPolling.forFragment(element).forceStop();
     }
     function shouldPoll(fragment) {
         var _a, _b;
@@ -23716,7 +23840,17 @@ up.radio = (function () {
     </div>
     ```
   
-    ### Skipping updates when nothing changed
+    ### Skipping updates on the client
+  
+    Client-side code may skip an update by preventing an `up:fragment:poll` event
+    on the polling fragment.
+  
+    Unpoly will also choose to skip updates under certain conditions,
+    e.g. when the browser tab is in the background. See `up.radio.config.pollEnabled` for details.
+  
+    When an update is skipped, Unpoly will try to poll again after the configured interval.
+  
+    ### Skipping updates on the server
   
     When polling a fragment periodically we want to avoid rendering unchanged content.
     This saves <b>CPU time</b> and reduces the <b>bandwidth cost</b> for a
@@ -23725,26 +23859,57 @@ up.radio = (function () {
     To achieve this we timestamp your fragments with an `[up-time]` attribute to indicate
     when the underlying data was last changed. See `[up-time]` for a detailed example.
   
+    If the server has no more recent changes, it may skip the update by responding
+    with an HTTP status `304 Not Modified`.
+  
+    When an update is skipped, Unpoly will try to poll again after the configured interval.
+  
+    ### Stopping polling
+  
+    - The fragment from the server response no longer has an `[up-poll]` attribute.
+    - Client-side code has called `up.radio.stopPolling()` with the polling element.
+    - Polling was [disabled globally](/up.radio.config#config.pollEnabled).
+  
     @selector [up-poll]
     @param [up-interval]
       The reload interval in milliseconds.
   
       Defaults to `up.radio.config.pollInterval`.
+    @param [up-source]
+      The URL from which to reload the fragment.
+  
+      Defaults to the closest `[up-source]` attribute of an ancestor element.
     @stable
     */
-    up.compiler('[up-poll]', startPolling);
+    up.compiler('[up-poll]', function (fragment) {
+        up.FragmentPolling.forFragment(fragment).onPollAttributeObserved();
+    });
+    /*-
+    This event is emitted before a [polling](/up-poll) fragment is reloaded from the server.
+  
+    Listener may prevent the `up:fragment:poll` event to prevent the fragment from being reloaded.
+    Preventing the event will only skip a single update. It will *not* stop future polling.
+  
+    @event up:fragment:poll
+    @param {Element} event.target
+      The polling fragment.
+    @param event.preventDefault()
+      Event listeners may call this method to prevent the fragment from being reloaded.
+    @experimental
+    */
     up.on('up:framework:reset', reset);
     return {
         config: config,
         hungrySelector: hungrySelector,
         startPolling: startPolling,
-        stopPolling: stopPolling
+        stopPolling: stopPolling,
+        shouldPoll: shouldPoll,
     };
 })();
 
 
 /***/ }),
-/* 90 */
+/* 91 */
 /***/ (function() {
 
 /*
@@ -23884,15 +24049,16 @@ __webpack_require__(73);
 __webpack_require__(74);
 __webpack_require__(75);
 __webpack_require__(76);
-__webpack_require__(78);
-__webpack_require__(80);
+__webpack_require__(77);
+__webpack_require__(79);
 __webpack_require__(81);
-__webpack_require__(83);
-__webpack_require__(85);
-__webpack_require__(87);
+__webpack_require__(82);
+__webpack_require__(84);
+__webpack_require__(86);
 __webpack_require__(88);
 __webpack_require__(89);
 __webpack_require__(90);
+__webpack_require__(91);
 up.framework.onEvaled();
 
 }();