unpoly-rails 2.6.0 → 2.7.1

data/assets/unpoly/unpoly.es5.js

@@ -8,7 +8,7 @@
 @module up
 */
 window.up = {
-    version: '2.6.0'
+    version: '2.7.1'
 };
 
 
@@ -51,6 +51,8 @@ You will recognize many functions form other utility libraries like [Lodash](htt
 While feature parity with Lodash is not a goal of `up.util`, you might find it sufficient
 to not include another library in your asset bundle.
 
+@see url-patterns
+
 @module up.util
 */
 up.util = (function () {
@@ -2357,7 +2359,7 @@ up.browser = (function () {
 
 /***/ }),
 /* 7 */
-/***/ (function() {
+/***/ (function(__unused_webpack_module, __unused_webpack_exports, __webpack_require__) {
 
 var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
@@ -2368,6 +2370,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     }
     return to.concat(ar || Array.prototype.slice.call(from));
 };
+__webpack_require__(8);
 /*-
 DOM helpers
 ===========
@@ -2636,44 +2639,89 @@ up.element = (function () {
     /*-
     Hides the given element.
   
-    The element is hidden by setting an [inline style](https://www.codecademy.com/articles/html-inline-styles)
-    of `{ display: none }`.
+    Also see `up.element.show()` and `up.element.toggle()`.
+  
+    ### Implementation
   
-    Also see `up.element.show()`.
+    The element is hidden by setting an `[hidden]` attribute.
+    This effectively gives the element a `display: none` rule.
+  
+    To customize the CSS rule for hiding, see `[hidden]`.
   
     @function up.element.hide
     @param {Element} element
     @stable
     */
     function hide(element) {
-        element.style.display = 'none';
+        // Set an attribute that the user can style with custom "hidden" styles.
+        // E.g. certain JavaScript components cannot initialize properly within a
+        // { display: none }, as such an element has no width or height.
+        element.setAttribute('hidden', '');
+    }
+    /*-
+    Elements with this attribute are hidden from the page.
+  
+    While `[hidden]` is a [standard HTML attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)
+    its default implementation is [not very useful](https://meowni.ca/hidden.is.a.lie.html).
+    In particular it cannot hide elements with any `display` rule.
+    Unpoly improves the default CSS styles of `[hidden]` so it can hide arbitrary elements.
+  
+    ## Customizing the CSS
+  
+    Unpoly's default styles for `[hidden]` look like this:
+  
+    ```css
+    [hidden][hidden] {
+      display: none !important;
+    }
+    ```
+  
+    You can override the CSS to hide an element in a different way, e.g. by giving it a zero height:
+  
+    ```css
+    .my-element[hidden] {
+      display: block !important;
+      height: 0 !important;
     }
+    ```
+  
+    Note that any overriding selector must have a [specificity of `(0, 2, 0)`](https://polypane.app/css-specificity-calculator/#selector=.element%5Bhidden%5D).
+    Also all rules should be defined with [`!important`](https://www.w3schools.com/css/css_important.asp) to override other
+    styles defined on that element.
+  
+    @selector [hidden]
+    @experimental
+    */
     /*-
     Shows the given element.
   
-    Also see `up.element.hide()`.
+    Also see `up.element.hide()` and `up.element.toggle()`.
   
     ### Limitations
   
-    The element is shown by setting an [inline style](https://www.codecademy.com/articles/html-inline-styles)
-    of `{ display: '' }`.
+    The element is shown by removing the `[hidden]` attribute set by `up.element.hide()`.
+    In case the element is hidden by an inline style (`[style="display: none"]`),
+    that inline style is also removed.
   
-    You might have CSS rules causing the element to remain hidden after calling `up.element.show(element)`.
-    Unpoly will not handle such cases in order to keep this function performant. As a workaround, you may
-    manually set the `element.style.display` property. Also see discussion
-    in jQuery issues [#88](https://github.com/jquery/jquery.com/issues/88),
-    [#2057](https://github.com/jquery/jquery/issues/2057) and
-    [this WHATWG mailing list post](http://lists.w3.org/Archives/Public/public-whatwg-archive/2014Apr/0094.html).
+    You may have CSS rules causing the element to remain hidden after calling `up.element.show(element)`.
+    Unpoly will *not* handle such cases in order to keep this function performant. As a workaround, you may
+    manually set `element.style.display = 'block'`.
   
     @function up.element.show
     @param {Element} element
     @stable
     */
     function show(element) {
-        element.style.display = '';
+        // Remove the attribute set by `up.element.hide()`.
+        element.removeAttribute('hidden');
+        // In case the element was manually hidden through an inline style
+        // of `display: none`, we also remove that.
+        if (element.style.display === 'none') {
+            element.style.display = '';
+        }
     }
     /*-
-    Display or hide the given element, depending on its current visibility.
+    Changes whether the given element is [shown](/up.element.show) or [hidden](/up.element.hide).
   
     @function up.element.toggle
     @param {Element} element
@@ -2689,10 +2737,6 @@ up.element = (function () {
         }
         (newVisible ? show : hide)(element);
     }
-    //  trace = (fn) ->
-    //    (args...) ->
-    //      console.debug("Calling %o with %o", fn, args)
-    //      fn(args...)
     /*-
     Adds or removes the given class from the given element.
   
@@ -3647,6 +3691,12 @@ up.element = (function () {
 /* 8 */
 /***/ (function() {
 
+
+
+/***/ }),
+/* 9 */
+/***/ (function() {
+
 var u = up.util;
 up.Record = /** @class */ (function () {
     function Record(options) {
@@ -3677,7 +3727,7 @@ up.Record = /** @class */ (function () {
 
 
 /***/ }),
-/* 9 */
+/* 10 */
 /***/ (function() {
 
 var u = up.util;
@@ -3695,18 +3745,9 @@ up.Config = /** @class */ (function () {
 
 
 /***/ }),
-/* 10 */
+/* 11 */
 /***/ (function() {
 
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
 var u = up.util;
 /*-
 @class up.Cache
@@ -3721,8 +3762,6 @@ up.Cache = /** @class */ (function () {
     @param {number|Function(): number} [config.expiry]
       The number of milliseconds after which a cache entry
       will be discarded.
-    @param {string} [config.logPrefix]
-      A prefix for log entries printed by this cache object.
     @param {Function(entry): string} [config.key]
       A function that takes an argument and returns a string key
       for storage. If omitted, `toString()` is called on the argument.
@@ -3760,16 +3799,6 @@ up.Cache = /** @class */ (function () {
     Cache.prototype.clear = function () {
         this.store.clear();
     };
-    Cache.prototype.log = function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        if (this.config.logPrefix) {
-            args[0] = "[".concat(this.config.logPrefix, "] ").concat(args[0]);
-            up.puts.apply(up, __spreadArray(['up.Cache'], args, false));
-        }
-    };
     Cache.prototype.keys = function () {
         return this.store.keys();
     };
@@ -3834,36 +3863,24 @@ up.Cache = /** @class */ (function () {
             return true;
         }
     };
-    Cache.prototype.get = function (key, options) {
-        if (options === void 0) { options = {}; }
+    Cache.prototype.get = function (key) {
         var storeKey = this.normalizeStoreKey(key);
         var entry = this.store.get(storeKey);
         if (entry) {
             if (this.isFresh(entry)) {
-                if (!options.silent) {
-                    this.log("Cache hit for '%s'", key);
-                }
                 return entry.value;
             }
             else {
-                if (!options.silent) {
-                    this.log("Discarding stale cache entry for '%s'", key);
-                }
                 this.remove(key);
             }
         }
-        else {
-            if (!options.silent) {
-                this.log("Cache miss for '%s'", key);
-            }
-        }
     };
     return Cache;
 }());
 
 
 /***/ }),
-/* 11 */
+/* 12 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -3916,7 +3933,7 @@ up.Rect = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 12 */
+/* 13 */
 /***/ (function() {
 
 var e = up.element;
@@ -3988,7 +4005,7 @@ up.BodyShifter = /** @class */ (function () {
 
 
 /***/ }),
-/* 13 */
+/* 14 */
 /***/ (function() {
 
 var u = up.util;
@@ -4024,7 +4041,7 @@ up.Change = /** @class */ (function () {
 
 
 /***/ }),
-/* 14 */
+/* 15 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -4126,7 +4143,7 @@ up.Change.Addition = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 15 */
+/* 16 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -4154,7 +4171,7 @@ up.Change.Removal = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 16 */
+/* 17 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -4286,7 +4303,7 @@ up.Change.DestroyFragment = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 17 */
+/* 18 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -4484,7 +4501,7 @@ up.Change.OpenLayer = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 18 */
+/* 19 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -4960,7 +4977,7 @@ up.Change.UpdateLayer = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 19 */
+/* 20 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -5021,10 +5038,13 @@ up.Change.CloseLayer = /** @class */ (function (_super) {
     };
     CloseLayer.prototype.emitCloseEvent = function () {
         // The close event is emitted on the layer that is about to close.
-        return this.layer.emit(this.buildEvent("up:layer:".concat(this.verb)), {
+        var event = 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, " with value %o"), this.value]
         });
+        // Allow an event listener to replace event.value with a new value.
+        this.value = event.value;
+        return event;
     };
     CloseLayer.prototype.emitClosedEvent = function (formerParent) {
         var verbPast = "".concat(this.verb, "ed");
@@ -5066,7 +5086,7 @@ up.Change.CloseLayer = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 20 */
+/* 21 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -5246,7 +5266,7 @@ up.Change.FromContent = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 21 */
+/* 22 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -5431,7 +5451,7 @@ up.Change.FromURL = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 22 */
+/* 23 */
 /***/ (function() {
 
 var u = up.util;
@@ -5562,7 +5582,7 @@ up.CompilerPass = /** @class */ (function () {
 
 
 /***/ }),
-/* 23 */
+/* 24 */
 /***/ (function() {
 
 var u = up.util;
@@ -5691,7 +5711,7 @@ up.CSSTransition = /** @class */ (function () {
 
 
 /***/ }),
-/* 24 */
+/* 25 */
 /***/ (function() {
 
 var __assign = (this && this.__assign) || function () {
@@ -5748,7 +5768,7 @@ up.DestructorPass = /** @class */ (function () {
 
 
 /***/ }),
-/* 25 */
+/* 26 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -5918,7 +5938,7 @@ up.EventEmitter = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 26 */
+/* 27 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -6081,7 +6101,7 @@ up.EventListener = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 27 */
+/* 28 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -6201,7 +6221,7 @@ up.EventListenerGroup = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 28 */
+/* 29 */
 /***/ (function() {
 
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
@@ -6345,7 +6365,7 @@ up.FieldObserver = /** @class */ (function () {
 
 
 /***/ }),
-/* 29 */
+/* 30 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -6422,7 +6442,7 @@ up.FocusCapsule = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 30 */
+/* 31 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -6502,7 +6522,7 @@ up.FragmentProcessor = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 31 */
+/* 32 */
 /***/ (function() {
 
 var DESCENDANT_SELECTOR = /^([^ >+(]+) (.+)$/;
@@ -6541,7 +6561,7 @@ up.FragmentFinder = /** @class */ (function () {
 
 
 /***/ }),
-/* 32 */
+/* 33 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -6642,7 +6662,7 @@ up.FragmentFocus = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 33 */
+/* 34 */
 /***/ (function() {
 
 var e = up.element;
@@ -6753,7 +6773,7 @@ up.FragmentPolling = /** @class */ (function () {
 
 
 /***/ }),
-/* 34 */
+/* 35 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -6862,7 +6882,7 @@ up.FragmentScrolling = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 35 */
+/* 36 */
 /***/ (function() {
 
 var u = up.util;
@@ -6905,7 +6925,7 @@ up.HTMLWrapper = /** @class */ (function () {
 
 
 /***/ }),
-/* 36 */
+/* 37 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -6945,6 +6965,7 @@ even if that layer is not the frontmost layer. E.g. if you're compiling a fragme
 the background layer during compilation.
 
 @class up.Layer
+@parent up.layer
 */
 up.Layer = /** @class */ (function (_super) {
     __extends(Layer, _super);
@@ -7601,7 +7622,7 @@ up.Layer = /** @class */ (function (_super) {
             }
         },
         set: function (location) {
-            var previousLocation = this.savedLocation;
+            var previousLocation = this.location;
             location = up.history.normalizeURL(location);
             if (previousLocation !== location) {
                 this.savedLocation = location;
@@ -7667,7 +7688,7 @@ up.Layer = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 37 */
+/* 38 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8064,7 +8085,7 @@ up.Layer.Overlay = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 38 */
+/* 39 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8129,7 +8150,7 @@ up.Layer.OverlayWithTether = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 39 */
+/* 40 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8201,7 +8222,7 @@ up.Layer.OverlayWithViewport = (_a = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 40 */
+/* 41 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8295,7 +8316,7 @@ up.Layer.Root = (_a = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 41 */
+/* 42 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8326,7 +8347,7 @@ up.Layer.Modal = (_a = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 42 */
+/* 43 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8357,7 +8378,7 @@ up.Layer.Popup = (_a = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 43 */
+/* 44 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8388,7 +8409,7 @@ up.Layer.Drawer = (_a = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 44 */
+/* 45 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8419,7 +8440,7 @@ up.Layer.Cover = (_a = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 45 */
+/* 46 */
 /***/ (function() {
 
 var __assign = (this && this.__assign) || function () {
@@ -8461,7 +8482,7 @@ up.LayerLookup = /** @class */ (function () {
         }
         this.values = u.splitValues(options.layer);
         this.origin = options.origin;
-        this.baseLayer = options.baseLayer || this.stack.current;
+        this.baseLayer = options.baseLayer || this.originLayer() || this.stack.current;
         if (u.isString(this.baseLayer)) {
             // The { baseLayer } option may itself be a string like "parent".
             // In this case we look it up using a new up.LayerLookup instance, using
@@ -8544,7 +8565,7 @@ up.LayerLookup = /** @class */ (function () {
 
 
 /***/ }),
-/* 46 */
+/* 47 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -8749,7 +8770,7 @@ up.LayerStack = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 47 */
+/* 48 */
 /***/ (function() {
 
 up.LinkFeedbackURLs = /** @class */ (function () {
@@ -8784,7 +8805,7 @@ up.LinkFeedbackURLs = /** @class */ (function () {
 
 
 /***/ }),
-/* 48 */
+/* 49 */
 /***/ (function() {
 
 var u = up.util;
@@ -8865,7 +8886,7 @@ up.LinkPreloader = /** @class */ (function () {
 
 
 /***/ }),
-/* 49 */
+/* 50 */
 /***/ (function() {
 
 var __assign = (this && this.__assign) || function () {
@@ -9118,7 +9139,7 @@ up.MotionController = /** @class */ (function () {
 
 
 /***/ }),
-/* 50 */
+/* 51 */
 /***/ (function() {
 
 var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
@@ -9249,7 +9270,7 @@ up.NonceableCallback = /** @class */ (function () {
 
 
 /***/ }),
-/* 51 */
+/* 52 */
 /***/ (function() {
 
 var __assign = (this && this.__assign) || function () {
@@ -9327,7 +9348,7 @@ up.OptionsParser = /** @class */ (function () {
 
 
 /***/ }),
-/* 52 */
+/* 53 */
 /***/ (function() {
 
 var e = up.element;
@@ -9421,7 +9442,7 @@ up.OverlayFocus = /** @class */ (function () {
 
 
 /***/ }),
-/* 53 */
+/* 54 */
 /***/ (function() {
 
 var u = up.util;
@@ -9445,6 +9466,7 @@ The following types of parameter representation are supported:
    On IE 11 and Edge, `FormData` payloads require a [polyfill for `FormData#entries()`](https://github.com/jimmywarting/FormData).
 
 @class up.Params
+@parent up.form
 */
 up.Params = /** @class */ (function () {
     /*-
@@ -9815,7 +9837,7 @@ up.Params = /** @class */ (function () {
     @param {string} name
     @return {any}
       The value of the param with the given name.
-    @internal
+    @experimental
     */
     Params.prototype.getFirst = function (name) {
         var entry = u.find(this.entries, this.matchEntryFn(name));
@@ -9830,7 +9852,7 @@ up.Params = /** @class */ (function () {
     @param {string} name
     @return {Array}
       An array of all values with the given name.
-    @internal
+    @experimental
     */
     Params.prototype.getAll = function (name) {
         if (this.isArrayKey(name)) {
@@ -10018,7 +10040,7 @@ up.Params = /** @class */ (function () {
 
 
 /***/ }),
-/* 54 */
+/* 55 */
 /***/ (function() {
 
 var e = up.element;
@@ -10076,7 +10098,7 @@ up.ProgressBar = /** @class */ (function () {
 
 
 /***/ }),
-/* 55 */
+/* 56 */
 /***/ (function() {
 
 var u = up.util;
@@ -10215,7 +10237,7 @@ up.RenderOptions = (function () {
 
 
 /***/ }),
-/* 56 */
+/* 57 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -10245,6 +10267,7 @@ console.log(result.layer)     // => up.Layer.Root
 ```
 
 @class up.RenderResult
+@parent up.fragment
 */
 up.RenderResult = /** @class */ (function (_super) {
     __extends(RenderResult, _super);
@@ -10276,7 +10299,7 @@ up.RenderResult = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 57 */
+/* 58 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -10310,6 +10333,7 @@ console.log(response.text)
 ```
 
 @class up.Request
+@parent up.network
 */
 up.Request = /** @class */ (function (_super) {
     __extends(Request, _super);
@@ -10578,6 +10602,23 @@ up.Request = /** @class */ (function (_super) {
             'onQueued'
         ];
     };
+    Object.defineProperty(Request.prototype, "xhr", {
+        /*-
+        Returns the underlying `XMLHttpRequest` instance.
+      
+        @property up.Request#xhr
+        @param {XMLHttpRequest} xhr
+        @stable
+        */
+        get: function () {
+            var _a;
+            // Initialize the xhr request on first access,
+            // so listeners on up:request:send events have a chance to access the xhr.
+            return (_a = this._xhr) !== null && _a !== void 0 ? _a : (this._xhr = new XMLHttpRequest());
+        },
+        enumerable: false,
+        configurable: true
+    });
     Request.prototype.followState = function (sourceRequest) {
         u.delegate(this, ['deferred', 'state', 'preload'], function () { return sourceRequest; });
     };
@@ -10659,7 +10700,7 @@ up.Request = /** @class */ (function (_super) {
         }
         this.state = 'loading';
         // Convert from XHR's callback-based API to up.Request's promise-based API
-        this.xhr = new up.Request.XHRRenderer(this).buildAndSend({
+        new up.Request.XHRRenderer(this).buildAndSend({
             onload: function () { return _this.onXHRLoad(); },
             onerror: function () { return _this.onXHRError(); },
             ontimeout: function () { return _this.onXHRTimeout(); },
@@ -10752,8 +10793,8 @@ up.Request = /** @class */ (function (_super) {
     Request.prototype.abort = function () {
         // setAbortedState() must be called before xhr.abort(), since xhr's event handlers
         // will call setAbortedState() a second time, without a message.
-        if (this.setAbortedState() && this.xhr) {
-            this.xhr.abort();
+        if (this.setAbortedState() && this._xhr) {
+            this._xhr.abort();
         }
     };
     Request.prototype.setAbortedState = function (reason) {
@@ -10908,7 +10949,7 @@ up.Request.tester = function (condition) {
 
 
 /***/ }),
-/* 58 */
+/* 59 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -10975,7 +11016,7 @@ up.Request.Cache = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 59 */
+/* 60 */
 /***/ (function() {
 
 var u = up.util;
@@ -11129,7 +11170,7 @@ up.Request.Queue = /** @class */ (function () {
 
 
 /***/ }),
-/* 60 */
+/* 61 */
 /***/ (function() {
 
 var u = up.util;
@@ -11182,7 +11223,7 @@ up.Request.FormRenderer = /** @class */ (function () {
 
 
 /***/ }),
-/* 61 */
+/* 62 */
 /***/ (function() {
 
 var CONTENT_TYPE_URL_ENCODED = 'application/x-www-form-urlencoded';
@@ -11193,40 +11234,39 @@ up.Request.XHRRenderer = /** @class */ (function () {
         this.request = request;
     }
     XHRRenderer.prototype.buildAndSend = function (handlers) {
-        this.xhr = new XMLHttpRequest();
+        var xhr = this.request.xhr;
         // We copy params since we will modify them below.
         // This would confuse API clients and cache key logic in up.network.
         this.params = u.copy(this.request.params);
         // IE11 explodes it we're setting an undefined timeout property
         if (this.request.timeout) {
-            this.xhr.timeout = this.request.timeout;
+            xhr.timeout = this.request.timeout;
         }
         // The XMLHttpRequest method must be opened before we can add headers to it.
-        this.xhr.open(this.getMethod(), this.request.url);
-        // Add information about the response's intended use so the server may
+        xhr.open(this.getMethod(), this.request.url);
+        // Add information about the response's intended use, so the server may
         // customize or shorten its response.
         var metaProps = this.request.metaProps();
         for (var key in metaProps) {
-            this.addHeader(up.protocol.headerize(key), metaProps[key]);
+            this.addHeader(xhr, up.protocol.headerize(key), metaProps[key]);
         }
         for (var header in this.request.headers) {
-            this.addHeader(header, this.request.headers[header]);
+            this.addHeader(xhr, header, this.request.headers[header]);
         }
         var csrfHeader, csrfToken;
         if ((csrfHeader = this.request.csrfHeader()) && (csrfToken = this.request.csrfToken())) {
-            this.addHeader(csrfHeader, csrfToken);
+            this.addHeader(xhr, csrfHeader, csrfToken);
         }
-        this.addHeader(up.protocol.headerize('version'), up.version);
+        this.addHeader(xhr, up.protocol.headerize('version'), up.version);
         // The { contentType } will be missing in case of a FormData payload.
         // In this case the browser will choose a content-type with MIME boundary,
         // like: multipart/form-data; boundary=----WebKitFormBoundaryHkiKAbOweEFUtny8
         var contentType = this.getContentType();
         if (contentType) {
-            this.addHeader('Content-Type', contentType);
+            this.addHeader(xhr, 'Content-Type', contentType);
         }
-        u.assign(this.xhr, handlers);
-        this.xhr.send(this.getPayload());
-        return this.xhr;
+        u.assign(xhr, handlers);
+        xhr.send(this.getPayload());
     };
     XHRRenderer.prototype.getMethod = function () {
         // By default HTTP methods other than `GET` or `POST` will be converted into a `POST`
@@ -11249,11 +11289,11 @@ up.Request.XHRRenderer = /** @class */ (function () {
         this.finalizePayload();
         return this.payload;
     };
-    XHRRenderer.prototype.addHeader = function (header, value) {
+    XHRRenderer.prototype.addHeader = function (xhr, header, value) {
         if (u.isOptions(value) || u.isArray(value)) {
             value = JSON.stringify(value);
         }
-        this.xhr.setRequestHeader(header, value);
+        xhr.setRequestHeader(header, value);
     };
     XHRRenderer.prototype.finalizePayload = function () {
         if (this.payloadFinalized) {
@@ -11290,7 +11330,7 @@ up.Request.XHRRenderer = /** @class */ (function () {
 
 
 /***/ }),
-/* 62 */
+/* 63 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -11319,6 +11359,7 @@ A response to an [HTTP request](/up.request).
     })
 
 @class up.Response
+@parent up.network
 */
 up.Response = /** @class */ (function (_super) {
     __extends(Response, _super);
@@ -11508,7 +11549,7 @@ up.Response = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 63 */
+/* 64 */
 /***/ (function() {
 
 var u = up.util;
@@ -11617,7 +11658,7 @@ up.ResponseDoc = /** @class */ (function () {
 
 
 /***/ }),
-/* 64 */
+/* 65 */
 /***/ (function() {
 
 var e = up.element;
@@ -11709,7 +11750,8 @@ up.RevealMotion = /** @class */ (function () {
         elementRect.height += 2 * this.padding;
     };
     RevealMotion.prototype.selectObstructions = function (selectors) {
-        return up.fragment.all(selectors.join(','), { layer: this.obstructionsLayer });
+        var elements = up.fragment.all(selectors.join(','), { layer: this.obstructionsLayer });
+        return u.filter(elements, e.isVisible);
     };
     RevealMotion.prototype.substractObstructions = function (viewportRect) {
         for (var _i = 0, _a = this.selectObstructions(this.topObstructions); _i < _a.length; _i++) {
@@ -11739,7 +11781,7 @@ up.RevealMotion = /** @class */ (function () {
 
 
 /***/ }),
-/* 65 */
+/* 66 */
 /***/ (function() {
 
 var u = up.util;
@@ -11819,7 +11861,7 @@ up.ScrollMotion = /** @class */ (function () {
 
 
 /***/ }),
-/* 66 */
+/* 67 */
 /***/ (function() {
 
 var e = up.element;
@@ -11873,7 +11915,7 @@ up.Selector = /** @class */ (function () {
 
 
 /***/ }),
-/* 67 */
+/* 68 */
 /***/ (function() {
 
 var u = up.util;
@@ -11908,7 +11950,7 @@ up.store.Memory = /** @class */ (function () {
 
 
 /***/ }),
-/* 68 */
+/* 69 */
 /***/ (function() {
 
 var __extends = (this && this.__extends) || (function () {
@@ -11996,7 +12038,7 @@ up.store.Session = /** @class */ (function (_super) {
 
 
 /***/ }),
-/* 69 */
+/* 70 */
 /***/ (function() {
 
 var u = up.util;
@@ -12158,7 +12200,7 @@ up.Tether = /** @class */ (function () {
 
 
 /***/ }),
-/* 70 */
+/* 71 */
 /***/ (function() {
 
 var u = up.util;
@@ -12252,7 +12294,7 @@ up.URLPattern = /** @class */ (function () {
 
 
 /***/ }),
-/* 71 */
+/* 72 */
 /***/ (function() {
 
 /*-
@@ -12463,7 +12505,7 @@ up.boot = up.framework.boot;
 
 
 /***/ }),
-/* 72 */
+/* 73 */
 /***/ (function() {
 
 /*-
@@ -13056,7 +13098,7 @@ up.emit = up.event.emit;
 
 
 /***/ }),
-/* 73 */
+/* 74 */
 /***/ (function() {
 
 /*-
@@ -13855,7 +13897,7 @@ up.protocol = (function () {
 
 
 /***/ }),
-/* 74 */
+/* 75 */
 /***/ (function() {
 
 var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
@@ -14078,7 +14120,7 @@ up.warn = up.log.warn;
 
 
 /***/ }),
-/* 75 */
+/* 76 */
 /***/ (function() {
 
 /*-
@@ -14087,6 +14129,8 @@ Custom JavaScript
 
 The `up.syntax` package lets you pair HTML elements with JavaScript behavior.
 
+@see legacy-scripts
+
 @see up.compiler
 @see [up-data]
 @see up.macro
@@ -14599,7 +14643,7 @@ up.data = up.syntax.data;
 
 
 /***/ }),
-/* 76 */
+/* 77 */
 /***/ (function() {
 
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
@@ -14990,7 +15034,7 @@ up.history = (function () {
 
 
 /***/ }),
-/* 77 */
+/* 78 */
 /***/ (function(__unused_webpack_module, __unused_webpack_exports, __webpack_require__) {
 
 var __assign = (this && this.__assign) || function () {
@@ -15004,7 +15048,7 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
-__webpack_require__(78);
+__webpack_require__(79);
 var u = up.util;
 var e = up.element;
 /*-
@@ -15029,6 +15073,10 @@ a server-rendered web application:
 
 For low-level DOM utilities that complement the browser's native API, see `up.element`.
 
+@see navigation
+@see focus-option
+@see csp
+
 @see up.render
 @see up.navigate
 @see up.destroy
@@ -16843,13 +16891,13 @@ u.delegate(up, 'context', function () { return up.layer.current; });
 
 
 /***/ }),
-/* 78 */
+/* 79 */
 /***/ (function() {
 
 
 
 /***/ }),
-/* 79 */
+/* 80 */
 /***/ (function(__unused_webpack_module, __unused_webpack_exports, __webpack_require__) {
 
 var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
@@ -16861,10 +16909,10 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     }
     return to.concat(ar || Array.prototype.slice.call(from));
 };
-__webpack_require__(80);
+__webpack_require__(81);
 /*-
-Scrolling viewports
-===================
+Scrolling
+=========
 
 The `up.viewport` module controls the scroll position and focus within scrollable containers ("viewports").
 
@@ -16873,6 +16921,9 @@ define additional viewports by giving the CSS property `{ overflow-y: scroll }`
 
 Also see documentation for the [scroll option](/scroll-option) and [focus option](/focus-option).
 
+@see scroll-option
+@see scroll-tuning
+
 @see up.reveal
 @see [up-fixed=top]
 
@@ -17740,13 +17791,13 @@ up.reveal = up.viewport.reveal;
 
 
 /***/ }),
-/* 80 */
+/* 81 */
 /***/ (function() {
 
 
 
 /***/ }),
-/* 81 */
+/* 82 */
 /***/ (function() {
 
 var __assign = (this && this.__assign) || function () {
@@ -17839,6 +17890,8 @@ and [predefined animations](/up.animate#named-animations).
 You can define custom animations using `up.transition()` and
 `up.animation()`.
 
+@see motion-tuning
+
 @see a[up-transition]
 @see up.animation
 @see up.transition
@@ -18066,8 +18119,9 @@ up.motion = (function () {
     This event is emitted on an animating element by `up.motion.finish()` to
     request the animation to instantly finish and skip to the last frame.
   
-    Promises returned by animation and transition functions are expected
-    to settle.
+    Custom [animation](/up.animation) and [transition](/up.transition) functions are expected
+    to instantly settle their promises when this event is observed on the
+    animating element.
   
     Animations started by `up.animate()` already handle this event.
   
@@ -18500,10 +18554,10 @@ up.animate = up.motion.animate;
 
 
 /***/ }),
-/* 82 */
+/* 83 */
 /***/ (function(__unused_webpack_module, __unused_webpack_exports, __webpack_require__) {
 
-__webpack_require__(83);
+__webpack_require__(84);
 var u = up.util;
 /*-
 Network requests
@@ -18646,6 +18700,7 @@ up.network = (function () {
           return []
         }
       }
+      ```
   
     @param {boolean|Function(): boolean} [config.progressBar]
       Whether to show a progress bar for [late requests](/up:request:late).
@@ -19396,13 +19451,13 @@ up.cache = up.network.cache;
 
 
 /***/ }),
-/* 83 */
+/* 84 */
 /***/ (function() {
 
 
 
 /***/ }),
-/* 84 */
+/* 85 */
 /***/ (function(__unused_webpack_module, __unused_webpack_exports, __webpack_require__) {
 
 var __assign = (this && this.__assign) || function () {
@@ -19461,7 +19516,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     }
     return to.concat(ar || Array.prototype.slice.call(from));
 };
-__webpack_require__(85);
+__webpack_require__(86);
 var u = up.util;
 var e = up.element;
 /*-
@@ -19478,9 +19533,17 @@ or events from another layer. For instance, [fragment links](/up.link) will only
 unless you [explicitly target another layer](/layer-option).
 
 Overlays allow you to break up a complex screen into [subinteractions](/subinteractions).
-Subinteractions take place in overlays and may span one or many pages. The original screen remains open in the background.
+Subinteractions take place in overlays and may span one or many pages while the original screen remains open in the background.
 Once the subinteraction is *done*, the overlay is closed and a result value is communicated back to the parent layer.
 
+@see layer-terminology
+@see layer-option
+@see opening-overlays
+@see closing-overlays
+@see subinteractions
+@see customizing-overlays
+@see context
+
 @see a[up-layer=new]
 @see up.layer.current
 @see up.layer.on
@@ -20468,7 +20531,7 @@ up.layer = (function () {
     @stable
     */
     /*-
-    This event is emitted before a layer is [accepted](/closing-overlays).
+    This event is emitted *before* a layer is [accepted](/closing-overlays).
   
     The event is emitted on the [element of the layer](/up.layer.element) that is about to close.
   
@@ -20477,6 +20540,8 @@ up.layer = (function () {
       The layer that is about to close.
     @param {Element} [event.value]
       The overlay's [acceptance value](/closing-overlays#overlay-result-values).
+  
+      Listeners may replace or mutate this value.
     @param {Element} [event.origin]
       The element that is causing the layer to close.
     @param event.preventDefault()
@@ -20484,7 +20549,7 @@ up.layer = (function () {
     @stable
     */
     /*-
-    This event is emitted after a layer was [accepted](/closing-overlays).
+    This event is emitted *after* a layer was [accepted](/closing-overlays).
   
     The event is emitted on the [layer's](/up.layer.element) when the close animation
     is starting. If the layer has no close animaton and was already removed from the DOM,
@@ -20494,7 +20559,7 @@ up.layer = (function () {
     @param {up.Layer} event.layer
       The layer that was closed.
     @param {Element} [event.value]
-      The overlay's [acceptance value](/closing-overlays#overlay-result-values).
+      The overlay's final [acceptance value](/closing-overlays#overlay-result-values).
     @param {Element} [event.origin]
       The element that has caused the layer to close.
     @stable
@@ -20511,7 +20576,7 @@ up.layer = (function () {
     @stable
     */
     /*-
-    This event is emitted before a layer is [dismissed](/closing-overlays).
+    This event is emitted *before* a layer is [dismissed](/closing-overlays).
   
     The event is emitted on the [element of the layer](/up.layer.element) that is about to close.
   
@@ -20520,6 +20585,8 @@ up.layer = (function () {
       The layer that is about to close.
     @param {Element} [event.value]
       The overlay's [dismissal value](/closing-overlays#overlay-result-values).
+  
+      Listeners may replace or mutate this value.
     @param {Element} [event.origin]
       The element that is causing the layer to close.
     @param event.preventDefault()
@@ -20527,7 +20594,7 @@ up.layer = (function () {
     @stable
     */
     /*-
-    This event is emitted after a layer was [dismissed](/closing-overlays).
+    This event is emitted *after* a layer was [dismissed](/closing-overlays).
   
     The event is emitted on the [layer's](/up.layer.element) when the close animation
     is starting. If the layer has no close animaton and was already removed from the DOM,
@@ -20537,7 +20604,7 @@ up.layer = (function () {
     @param {up.Layer} event.layer
       The layer that was closed.
     @param {Element} [event.value]
-      The overlay's [dismissal value](/closing-overlays#overlay-result-values).
+      The overlay's final [dismissal value](/closing-overlays#overlay-result-values).
     @param {Element} [event.origin]
       The element that has caused the layer to close.
     @stable
@@ -20743,13 +20810,13 @@ up.layer = (function () {
 
 
 /***/ }),
-/* 85 */
+/* 86 */
 /***/ (function() {
 
 
 
 /***/ }),
-/* 86 */
+/* 87 */
 /***/ (function(__unused_webpack_module, __unused_webpack_exports, __webpack_require__) {
 
 var __assign = (this && this.__assign) || function () {
@@ -20772,7 +20839,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     }
     return to.concat(ar || Array.prototype.slice.call(from));
 };
-__webpack_require__(87);
+__webpack_require__(88);
 /*-
 Linking to fragments
 ====================
@@ -20796,7 +20863,7 @@ This makes for an unfriendly experience:
 - The user sees a "flash" as the browser loads and renders the new page,
   even if large portions of the old and new page are the same (navigation, layout, etc.).
 
-Unpoly fixes this by letting you annotate links with an [`up-target`](/a-up-follow#up-target)
+Unpoly fixes this by letting you annotate links with an [`[up-target]`](/a-up-follow#up-target)
 attribute. The value of this attribute is a CSS selector that indicates which page
 fragment to update. The server **still renders full HTML pages**, but we only use
 the targeted fragments and discard the rest:
@@ -20839,10 +20906,14 @@ with an `up-target` attribute:
 
 Note that instead of `article` you can use any other CSS selector like `#main .article`.
 
-With these [`up-target`](/a-up-follow#up-target) annotations Unpoly only updates the targeted part of the screen.
+With these [`[up-target]`](/a-up-follow#up-target) annotations Unpoly only updates the targeted part of the screen.
 The JavaScript environment will persist and the user will not see a white flash while the
 new page is loading.
 
+@see fragment-placement
+@see handling-everything
+@see server-errors
+
 @see a[up-follow]
 @see a[up-instant]
 @see a[up-preload]
@@ -21093,7 +21164,7 @@ up.link = (function () {
     }
     /*-
     Parses the [render](/up.render) options that would be used to
-    [`follow`](/up.follow) the given link, but does not render.
+    [follow](/up.follow) the given link, but does not render.
   
     ### Example
   
@@ -21925,13 +21996,13 @@ up.follow = up.link.follow;
 
 
 /***/ }),
-/* 87 */
+/* 88 */
 /***/ (function() {
 
 
 
 /***/ }),
-/* 88 */
+/* 89 */
 /***/ (function() {
 
 var __assign = (this && this.__assign) || function () {
@@ -21948,7 +22019,7 @@ var __assign = (this && this.__assign) || function () {
 /*-
 Forms
 =====
-  
+
 The `up.form` module helps you work with non-trivial forms.
 
 @see form[up-submit]
@@ -22136,7 +22207,7 @@ up.form = (function () {
     });
     /*-
     Parses the [render](/up.render) options that would be used to
-    [`submit`](/up.submit) the given form, but does not render.
+    [submit](/up.submit) the given form, but does not render.
   
     ### Example
   
@@ -23072,10 +23143,10 @@ up.form = (function () {
     ```html
     <input name="query" up-observe="showSuggestions(value)">
     ```
-    
+  
     Note that the parameter name in the markup must be called `value` or it will not work.
     The parameter name can be called whatever you want in the JavaScript, however.
-        
+  
     Also note that the function must be declared on the `window` object to work, like so:
   
     ```js
@@ -23244,7 +23315,7 @@ up.validate = up.form.validate;
 
 
 /***/ }),
-/* 89 */
+/* 90 */
 /***/ (function() {
 
 /*-
@@ -23681,7 +23752,7 @@ up.feedback = (function () {
 
 
 /***/ }),
-/* 90 */
+/* 91 */
 /***/ (function() {
 
 /*-
@@ -23909,7 +23980,7 @@ up.radio = (function () {
 
 
 /***/ }),
-/* 91 */
+/* 92 */
 /***/ (function() {
 
 /*
@@ -23980,7 +24051,6 @@ __webpack_require__(4);
 __webpack_require__(5);
 __webpack_require__(6);
 __webpack_require__(7);
-__webpack_require__(8);
 __webpack_require__(9);
 __webpack_require__(10);
 __webpack_require__(11);
@@ -24050,15 +24120,16 @@ __webpack_require__(74);
 __webpack_require__(75);
 __webpack_require__(76);
 __webpack_require__(77);
-__webpack_require__(79);
-__webpack_require__(81);
+__webpack_require__(78);
+__webpack_require__(80);
 __webpack_require__(82);
-__webpack_require__(84);
-__webpack_require__(86);
-__webpack_require__(88);
+__webpack_require__(83);
+__webpack_require__(85);
+__webpack_require__(87);
 __webpack_require__(89);
 __webpack_require__(90);
 __webpack_require__(91);
+__webpack_require__(92);
 up.framework.onEvaled();
 
 }();