RubyGems - unpoly-rails - Versions diffs - 2.0.0.pre.rc11 → 2.0.0 - Mend

unpoly-rails 2.0.0.pre.rc11 → 2.0.0

Potentially problematic release.

This version of unpoly-rails might be problematic. Click here for more details.

Files changed (8) hide show

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 16c5d23ef0ef94cd9a7cb5ef926ff4931aa1e2b19b32548c35b0fd527de83d91
-  data.tar.gz: 4748c57d0da382a24dd48f594ca3f61838387dc3fd3630da416843d8c45dc079
+  metadata.gz: 60a37ba382e3664b7224d805da146e4a7364e7880dbcdb80580a0e9ef4406672
+  data.tar.gz: 8d899df9850761c7b07849b2ded8a241e334c9e4cbc3ac8dc5003af0629206ad
 SHA512:
-  metadata.gz: 4b5ff85fee318e8200aef941b878d8bdac28872ff0a46e2e2468c3c28e883065daa30f96858418f900f6566632b0d469632ec8736cca550db2aa71c97fecacf0
-  data.tar.gz: 8f51f5822089f69e36da2a3c8cf7942bec84965014f0de1ebb524aaf13288697301e8fa68c747ee4b8d89a5e623eed5768bd904a87e0989ad0490527bdca2774
+  metadata.gz: 9caee93e9aa5f35eb7d7dcb276f1e48b1231b2f003e3bd56285105869f15759cbf7d2cfc57cf66dd2470b85df54775826352ea568e81f1151d1a981c04f0bc69
+  data.tar.gz: e53cee4842b88880f71769552dee074e4f865bfbae43033daf6c6a13950c73f0e5bf284ab7b9babfaff5677400ae0811111a8fac9dbafdd6a53e8a67b8c67796

data/CHANGELOG.md CHANGED Viewed

@@ -3,67 +3,135 @@ Changelog
 Changes to this project will be documented in this file.
+If you're upgrading from an older Unpoly version you should load [`unpoly-migrate.js`](https://unpoly.com/changes/upgrading) to enable deprecated APIs.
 You may browse a formatted and hyperlinked version of this file at <https://unpoly.com/changes>.
 2.0.0
 -----
-[See Unpoly 2 slides](http://triskweline.de/unpoly2-slides/)
-TODO
-----
-This list is **far** from complete.
-- up.network.config.slowDelay is now 800 (up from 300)
-- up.network.config.cacheSize is now 50 (down from 70)
-- up.network.isBusy() / isIdle() takes preload events into account
--  up.observe() callback may return a promise that will prevent callback calls while running
-- `[aria-label]` attributes are no longer used to build a target selector
-- Options removed form modals: up-width, up-max-width, up-height. Use up-size or up-class.
-- Failed responses now change the URL
-- TODO ...
-- up.history.config.restoreScroll has been removed.
-- Feedback works when a layer has no history
-- Layer A11Y
-  - inert
-  - aria-hidden
-  - focus new
-  - focus return on close
-- up.nav sets [aria-current]
-- up.history.config.enabled
-- Requests sent by Unpoly no longer have a `X-Requested-With: XMLHttpRequest` header.
-  If you need that old behavior: up.on('up:request:load', function(event) { event.request.headers['X-Requested-With'] = 'XMLHttpRequest' })
-- up.network.config.requestMetaKeys
-- up:link:follow is no longer sent when preloading, up:link:preload still is
-- Preserve focus when validating forms; Add { focus } option for fragment update
-- up.Request.prototype.isFatalError() has been removed without replacement. Network errors now reject with an error, and not a response.
-- [up-main], [up-main=overlay], [up-main=modal]
-- parseSelector can parse attribute selectors with prefix, infix, suffix, space-separated, dash-separated
-- up.validate() may now be called with a form element
-- validating emits up:form:validate instead of up:form:submit
-- When a compiler throws an error, other compilers will now run anyway
-- When a destructor throws an error, other destructors will now run anyway
-- Bootstrap integration
-  - Minimal: active, nav, navbar
-  - Bootstrap modal styles are no longer used for Unpoly modals
-  - Now supports three major Bootstrap versions:
-    - unpoly-bootstrap3.js
-    - unpoly-bootstrap4.js
-    - unpoly-bootstrap5.js
-- Hungry elements no longer get the transition by default. You need to set [up-transition] on the hungry element.
-- Rejections are now shown if the log is enabled
-- up.on() can passive: true
-- Preloads on touchstart and mousedown
-- Digit groups separators (`60_000`) are a stage 3 ES6 feature and also supported in number attributes.
+Unpoly 2 ships with many new features and API improvements, unlocking many use cases that were not possible with Unpoly 1.
+For an in-depth guide to all changes, see our [Unpoly 2 presentation](http://triskweline.de/unpoly2-slides/) (150 slides).
+If you're upgrading from an older Unpoly version you should load [`unpoly-migrate.js`](https://unpoly.com/changes/upgrading) to enable deprecated APIs. Also see below for an [overview of breaking changes](#overview-of-breaking-changes).
+### Change overview
+#### Less need for boilerplate configuration
+- Fragment links often replace the primary content element of your application layout. For this purpose you can now define [default targets](/up-main) that are automatically updated when no target selector is given.
+- Unpoly can be configured to [handle all links and forms](/handling-everything), without any `[up-...]` attributes.
+- We have examined many real-world Unpoly apps for repetitive configuration and made these options the new default.
+#### New Layer API
+- A new [layer API](/up.layer) replaces modals and popups.
+- Layers can be stacked infinitely.
+- Layers are fully isolated, meaning a screen in one layer will not accidentally see elements or events from another layer. For instance, [fragment links](/up.link) will only update elements from the [current layer](/up.layer.current) unless you [explicitly target another layer](/layer-option).
+- A variety of [overlay modes](/layer-terminology) are supported, such as modal dialogs, popup overlays or drawers. You may [customize their appearance and behavior](/customizing-overlays).
+#### Subinteractions
+- 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.
+- Once the subinteraction is *done*, the overlay is [closed](/closing-overlays) and a result value is communicated back to the parent layer.
+#### Navigation intent
+- You can now define whether a framgent update constitutes a user navigation. Switching screens needs other defaults than updating a tiny box.
+- User navigation aborts earlier requests, fixing race conditions on slow connections.
+#### Accessibility
+- New overlays are focused automatically and trap focus in a cycle. Closing the overlay re-focuses the link that opened it.
+- Focus is automatically managed when rendering major new content. A new [`[up-focus]` attribute](/focus-option) allows
+  you to explicitely move the user's focus as you update fragments.
+- Keyboard navigation is supported everywhere.
+- Focus, selection and scroll positions are preserved within an updated fragment.
+#### Reworked Bootstrap integration
+- The Bootstrap integration is now minimal and as unopinionated as possible. Little to no Bootstrap CSS is overridden.
+- Bootstrap versions 3, 4 and 5 are now supported.
+#### Quality of live improvements
+- Unpoly now ships with a bandwidth-friendly [polling implementation](/up-poll) that handles many edge cases.
+- The position of a clicked link is considered when deciding which element to replace. If possible, Unpoly will update an selector in the vicinity of the link that triggered the fragment update. This helps with multiple self-contained components (with the same selector) on the same page.
+- The [log](/up.log) output is more much more compact and has a calmer formatting.
+- New fragments are no longer revealed by default. Instead Unpoly scrolls to the top when the [main target](/up-main) has changed, but does not scroll otherwise.
+- History is no longer changed by default. Instead Unpoly updates history only when a [main target](/up-main) has changed.
+- All scroll-related options have been unified in a single [`[up-scroll]` attribute](/scroll-option).
+- Many optimizations have been made to preserve bandwidth on slow connections. For example, Unpoly stops [preloading](/up-preload) and [polling](/up-poll) whenthe connection has high latency or low throughput.
+- The client-side cache can be carefully managed by both the client and server.
+- Unpoly 1 had many functions for updating fragments (`up.replace()`, `up.extract()`, `up.modal.extract()`, etc.). Unpoly 2 has unified these into a single function `up.render()`.
+- Event handlers to `up:link:follow`, `up:form:submit` etc. may change the render options for the coming fragment update.
+- Added more options to handle [unexpected server responses](/server-errors), including the new `up:fragment:loaded` event.
+#### Extended server protocol
+The optional server protocol has been extended with additional headers that the server may use to interact with the frontend. For example:
+- The server may [emit events on the frontend](/X-Up-Events).
+- The server may [close overlays](/X-Up-Accept).
+- The server may [change the render target](/X-Up-Target) for a fragment update.
+See `up.protocol` for a full list of features.
+If you are using Ruby on Rails, the new protocol is already implemented by the [`unpoly-rails`](https://rubygems.org/gems/unpoly-rails) gem.
+If you are using Elixir / Phoenix, the new protocol is already implemented by the [`ex_unpoly`](https://hex.pm/packages/ex_unpoly) package.
+### Overview of breaking changes
+Please use [`unpoly-migrate.js`](/changes/upgrading) for a very smooth upgrade process from Unpoly 0.x or 1.x to Unpoly 2.0.
+By loading <code>unpoly-migrate.js</code>, calls to most old APIs will be forwarded to the new version. A deprecation notice will be logged to your browser console. This way you can upgrade Unpoly, revive your application with a few changes, then replace deprecated API calls under green tests.
+There's a short list of changes that we cannot fix with aliases.
+#### Overlays (modals, popups) have different HTML
+But it's similar. E.g. `<div class="modal">` becomes `<up-modal>`.
+#### Unpoly only sees the current layer
+You can target other layers with `{ layer: 'any' }`.
+#### Async functions no longer wait for animations
+You might or might not notice. In cases where you absolutely do need to wait, an `{ onFinished }` callback can be used.
+#### Tooltips are no longer built-in
+But there are a million better libraries.
+### Unpoly 1 maintenance
+With the release of Unpoly we're ending maintenance of Unpoly 1. Expect little to no changes to Unpoly 1 in the future. GitHub issues that have been fixed in Unpoly 2 will be closed.
+The legacy documentation for Unpoly 1.x has been archived to <https://v1.unpoly.com>.
 1.0.0
 -----
-- TODO
+For six years Unpoly has been released under a 0.x version number. To establish the maturity and stability of the project, we're releasing today's version as 1.0.0.
+There are only three changes from 0.62.1:
+- Fix a bug where `up.util.escapeHTML()`` would not escape single quotes.
+- Unpoly will no longer wait a JavaScript execution task to boot after `DOMContentLoaded`. This may improve the stability of test suites that previously interacted with the page too soon.
+- You may now disable the Unpoly banner in the development console with `up.log.config.banner = false`. (change by @hfjallemark).
+This is the last release of the 0.x API line. We're tracking its code in the [`1.x-stable`](https://github.com/unpoly/unpoly/tree/1.x-stable), but expect little to no changes in the future.
+The next release will be [Unpoly 2](https://triskweline.de/unpoly2-slides). It will include major (but mostly backwards compatible) renovations to its API, unlocking many use cases that were not possible with Unpoly 1.
 0.62.1

data/dist/unpoly-migrate.js CHANGED Viewed

@@ -300,6 +300,41 @@ Returns the first descendant element matching the given selector.
     return !event.defaultPrevented;
   };
+}).call(this);
+(function() {
+  var u;
+  u = up.util;
+  up.migrate.postCompile = function(elements, compiler) {
+    var element, i, keepValue, len, results, value;
+    if (keepValue = compiler.keep) {
+      up.migrate.warn('The { keep: true } option for up.compiler() has been removed. Have the compiler set [up-keep] attribute instead.');
+      value = u.isString(keepValue) ? keepValue : '';
+      results = [];
+      for (i = 0, len = elements.length; i < len; i++) {
+        element = elements[i];
+        results.push(element.setAttribute('up-keep', value));
+      }
+      return results;
+    }
+  };
+  up.migrate.targetMacro = function(queryAttr, fixedResultAttrs, callback) {
+    return up.macro("[" + queryAttr + "]", function(link) {
+      var optionalTarget, resultAttrs;
+      resultAttrs = u.copy(fixedResultAttrs);
+      if (optionalTarget = link.getAttribute(queryAttr)) {
+        resultAttrs['up-target'] = optionalTarget;
+      } else {
+        resultAttrs['up-follow'] = '';
+      }
+      e.setMissingAttrs(link, resultAttrs);
+      link.removeAttribute(queryAttr);
+      return typeof callback === "function" ? callback() : void 0;
+    });
+  };
 }).call(this);
 /***
@@ -538,6 +573,11 @@ Returns the first descendant element matching the given selector.
   up.migrate.renamedProperty(up.feedback.config, 'navs', 'navSelectors');
 }).call(this);
+/***
+@module up.link
+ */
 (function() {
   up.migrate.parseFollowOptions = function(parser) {
     parser.string('flavor');
@@ -549,6 +589,42 @@ Returns the first descendant element matching the given selector.
     return parser.boolean('restoreScroll');
   };
+  /***
+  [Follows](/up.follow) this link as fast as possible.
+  This is done by:
+  - [Following the link through AJAX](/a-up-follow) instead of a full page load
+  - [Preloading the link's destination URL](/a-up-preload)
+  - [Triggering the link on `mousedown`](/a-up-instant) instead of on `click`
+  \#\#\# Example
+  Use `[up-dash]` like this:
+      <a href="/users" up-dash=".main">User list</a>
+  This is shorthand for:
+      <a href="/users" up-target=".main" up-instant up-preload>User list</a>
+  @selector a[up-dash]
+  @param [up-dash='body']
+    The CSS selector to replace
+    Inside the CSS selector you may refer to this link as `&` ([like in Sass](https://sass-lang.com/documentation/file.SASS_REFERENCE.html#parent-selector)).
+  @deprecated
+    To accelerate all links use `up.link.config.instantSelectors` and `up.link.config.preloadSelectors`.
+   */
+  up.migrate.targetMacro('up-dash', {
+    'up-preload': '',
+    'up-instant': ''
+  }, function() {
+    return up.migrate.deprecated('a[up-dash]', 'up.link.config.instantSelectors or up.link.config.preloadSelectors');
+  });
 }).call(this);
 /***
@@ -826,10 +902,10 @@ Returns the first descendant element matching the given selector.
   @param {string} up-modal
     The CSS selector that will be extracted from the response and displayed in a modal dialog.
   @deprecated
-    Use `a[up-layer=modal]` instead.
+    Use `a[up-layer="new modal"]` instead.
    */
-  up.link.targetMacro('up-modal', {
+  up.migrate.targetMacro('up-modal', {
     'up-layer': 'new modal'
   }, function() {
     return up.migrate.deprecated('a[up-modal]', 'a[up-layer="new modal"]');
@@ -846,10 +922,10 @@ Returns the first descendant element matching the given selector.
   @param {string} up-drawer
     The CSS selector that will be extracted from the response and displayed in a modal dialog.
   @deprecated
-    Use `a[up-layer=drawer]` instead.
+    Use `a[up-layer="new drawer"]` instead.
    */
-  up.link.targetMacro('up-drawer', {
+  up.migrate.targetMacro('up-drawer', {
     'up-layer': 'new drawer'
   }, function() {
     return up.migrate.deprecated('a[up-drawer]', 'a[up-layer="new drawer"]');
@@ -1065,15 +1141,6 @@ This feature is now deprecated.
   up.migrate.renamedProperty(up.network.config, 'slowDelay', 'badResponseTime');
-  up.migrate.handleNetworkPreloadArgs = function() {
-    var args, ref;
-    args = 1 <= arguments.length ? slice.call(arguments, 0) : [];
-    if (u.isElementish(args[0])) {
-      up.migrate.warn('up.proxy.preload(link) has been renamed to up.link.preload(link)');
-      return (ref = up.link).preload.apply(ref, args);
-    }
-  };
   up.migrate.handleRequestOptions = function(options) {
     return up.migrate.fixKey(options, 'data', 'params');
   };
@@ -1086,11 +1153,13 @@ This feature is now deprecated.
   \#\#\# Example
-      up.request('/search', { params: { query: 'sunshine' } }).then(function(text) {
-        console.log('The response text is %o', text)
-      }).catch(function() {
-        console.error('The request failed')
-      })
+  ```
+  up.ajax('/search', { params: { query: 'sunshine' } }).then(function(text) {
+    console.log('The response text is %o', text)
+  }).catch(function() {
+    console.error('The request failed')
+  })
+  ```
   @function up.ajax
   @param {string} [url]
@@ -1129,6 +1198,13 @@ This feature is now deprecated.
     return up.cache.clear();
   };
+  up.network.preload = function() {
+    var args, ref;
+    args = 1 <= arguments.length ? slice.call(arguments, 0) : [];
+    up.migrate.deprecated('up.proxy.preload(link)', 'up.link.preload(link)');
+    return (ref = up.link).preload.apply(ref, args);
+  };
   /***
   @class up.Request
@@ -1183,26 +1259,6 @@ This feature is now deprecated.
 (function() {
   up.migrate.renamedProperty(up.radio.config, 'hungry', 'hungrySelectors');
-}).call(this);
-(function() {
-  var u;
-  u = up.util;
-  up.migrate.postCompile = function(elements, compiler) {
-    var element, i, keepValue, len, results, value;
-    if (keepValue = compiler.keep) {
-      up.migrate.warn('The { keep: true } option for up.compiler() has been removed. Have the compiler set [up-keep] attribute instead.');
-      value = u.isString(keepValue) ? keepValue : '';
-      results = [];
-      for (i = 0, len = elements.length; i < len; i++) {
-        element = elements[i];
-        results.push(element.setAttribute('up-keep', value));
-      }
-      return results;
-    }
-  };
 }).call(this);
 /***

data/dist/unpoly-migrate.min.js CHANGED Viewed

	@@ -1 +1 @@
1	- (function(){up.framework.startExtension()}).call(this),function(){var u,p,e,t,r,a,n,i,o,l,c,s,m,d,g=[].slice;u=up.util,up.migrate=(p=new up.Config(function(){return{logLevel:"warn"}}),c=function(e,t,r){var a;return a=function(){return m("Property { %s } has been renamed to { %s } (found in %o)",t,r,e)},Object.defineProperty(e,t,{get:function(){return a(),this[r]},set:function(e){return a(),this[r]=e}})},a=function(e,t,r){if(u.isDefined(e[t]))return m("Property { %s } has been renamed to { %s } (found in %o)",t,r,e),u.renameKey(e,t,r)},o={},i=function(e,t){return o[e]=t},t=function(e){var t;return(t=o[e])?(m("Event "+e+" has been renamed to "+t),t):e},r=function(e){return u.uniq(u.map(e,t))},l=function(e,t){return Object.defineProperty(up,e,{get:function(){return m("up."+e+" has been renamed to up."+t),up[t]}})},d={},m=function(e){var t,r,a,n;if(a=e,t=2<=arguments.length?g.call(arguments,1):[],r=u.sprintf.apply(u,[a].concat(g.call(t))),!d[r])return d[r]=!0,(n=up.log)[p.logLevel].apply(n,["DEPRECATION",a].concat(g.call(t)))},e=function(e,t){return m(e+" has been deprecated. Use "+t+" instead.")},n=function(e){var t,r;return r=Promise.resolve(),t=r.then,r.then=function(){return m(e+" is now a sync function"),t.apply(this,arguments)},r},s=function(){return p.reset()},up.on("up:framework:reset",s),{deprecated:e,renamedPackage:l,renamedProperty:c,formerlyAsync:n,renamedEvent:i,fixEventTypes:r,fixKey:a,warn:m,loaded:!0,config:p})}.call(this),function(){var a=[].slice;up.util.only=function(e){var t,r;return r=e,t=2<=arguments.length?a.call(arguments,1):[],up.migrate.deprecated("up.util.only(object, ...keys)","up.util.pick(object, keys)"),up.util.pick(r,t)},up.util.except=function(e){var t,r;return r=e,t=2<=arguments.length?a.call(arguments,1):[],up.migrate.deprecated("up.util.except(object, ...keys)","up.util.omit(object, keys)"),up.util.omit(r,t)},up.util.parseUrl=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.parseUrl() has been renamed to up.util.parseURL()"),(t=up.util).parseURL.apply(t,e)},up.util.any=function(){var e;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.any() has been renamed to up.util.some()"),some.apply(null,e)},up.util.all=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.all() has been renamed to up.util.every()"),(t=up.util).every.apply(t,e)},up.util.detect=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.detect() has been renamed to up.util.find()"),(t=up.util).find.apply(t,e)},up.util.select=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.select() has been renamed to up.util.filter()"),(t=up.util).filter.apply(t,e)},up.util.setTimer=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.setTimer() has been renamed to up.util.timer()"),(t=up.util).timer.apply(t,e)},up.util.escapeHtml=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.deprecated("up.util.escapeHtml","up.util.escapeHTML"),(t=up.util).escapeHTML.apply(t,e)},up.util.selectorForElement=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.selectorForElement() has been renamed to up.fragment.toTarget()"),(t=up.fragment).toTarget.apply(t,e)},up.util.nextFrame=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.nextFrame() has been renamed to up.util.task()"),(t=up.util).task.apply(t,e)}}.call(this),function(){var r=[].slice;up.element.first=function(){var e,t;return e=1<=arguments.length?r.call(arguments,0):[],up.migrate.deprecated("up.element.first()","up.element.get()"),(t=up.element).get.apply(t,e)},up.element.createFromHtml=function(){var e,t;return e=1<=arguments.length?r.call(arguments,0):[],up.migrate.deprecated("up.element.createFromHtml","up.element.createFromHTML"),(t=up.element).createFromHTML.apply(t,e)}}.call(this),function(){var t=[].slice;up.migrate.renamedPackage("bus","event"),up.event.nobodyPrevents=function(){var e;return e=1<=arguments.length?t.call(arguments,0):[],up.migrate.deprecated("up.event.nobodyPrevents(type)","!up.emit(type).defaultPrevented"),!up.emit.apply(up,e).defaultPrevented}}.call(this),function(){up.migrate.renamedProperty(up.form.config,"fields","fieldSelectors"),up.migrate.renamedProperty(up.form.config,"submitButtons","submitButtonSelectors")}.call(this),function(){var p,r=[].slice;p=up.util,up.migrate.renamedPackage("flow","fragment"),up.migrate.renamedPackage("dom","fragment"),up.migrate.renamedProperty(up.fragment.config,"fallbacks","mainTargets"),up.migrate.handleResponseDocOptions=function(e){return up.migrate.fixKey(e,"html","document")},up.replace=function(e,t,r){return up.migrate.deprecated("up.replace(target, url)","up.navigate(target, { url })"),up.navigate(p.merge(r,{target:e,url:t}))},up.extract=function(e,t,r){return up.migrate.deprecated("up.extract(target, document)","up.navigate(target, { document })"),up.navigate(p.merge(r,{target:e,document:t}))},up.fragment.first=function(){var e,t;return e=1<=arguments.length?r.call(arguments,0):[],up.migrate.deprecated("up.fragment.first()","up.fragment.get()"),(t=up.fragment).get.apply(t,e)},up.first=up.fragment.first,up.migrate.handleScrollOptions=function(e){if(p.isUndefined(e.scroll)&&(p.isString(e.reveal)?(up.migrate.deprecated("Option { reveal: '"+e.reveal+"' }","{ scroll: '"+e.reveal+"' }"),e.scroll=e.reveal):!0===e.reveal?(up.migrate.deprecated("Option { reveal: true }","{ scroll: 'target' }"),e.scroll="target"):!1===e.reveal&&(up.migrate.deprecated("Option { reveal: false }","{ scroll: false }"),e.scroll=!1),p.isDefined(e.resetScroll)&&(up.migrate.deprecated("Option { resetScroll: true }","{ scroll: 'reset' }"),e.scroll="teset"),p.isDefined(e.restoreScroll)))return up.migrate.deprecated("Option { restoreScroll: true }","{ scroll: 'restore' }"),e.scroll="restore"},up.migrate.handleHistoryOption=function(e){if(p.isString(e.history)&&"auto"!==e.history)return up.migrate.warn("Passing a URL as { history } option is deprecated. Pass it as { location } instead."),e.location=e.history,e.history="auto"},up.migrate.handleRenderOptions=function(e){var t,r,a,n,u;for(up.migrate.handleHistoryOption(e),u=[],t=0,r=(n=["target","origin"]).length;t<r;t++)a=n[t],p.isJQuery(e[a])?(up.migrate.warn("Passing a jQuery collection as { %s } is deprecated. Pass it as a native element instead.",a),u.push(e[a]=up.element.get(e[a]))):u.push(void 0);return u}}.call(this),function(){up.migrate.renamedProperty(up.history.config,"popTargets","restoreTargets"),up.history.url=function(){return up.migrate.deprecated("up.history.url()","up.history.location"),up.history.location},up.migrate.renamedEvent("up:history:push","up:location:changed"),up.migrate.renamedEvent("up:history:pushed","up:location:changed"),up.migrate.renamedEvent("up:history:restore","up:location:changed"),up.migrate.renamedEvent("up:history:restored","up:location:changed"),up.migrate.renamedEvent("up:history:replaced","up:location:changed")}.call(this),function(){up.migrate.renamedPackage("navigation","feedback"),up.migrate.renamedProperty(up.feedback.config,"navs","navSelectors")}.call(this),function(){up.migrate.parseFollowOptions=function(e){return e.string("flavor"),e.string("width"),e.string("height"),e["boolean"]("closable"),e.booleanOrString("reveal"),e["boolean"]("resetScroll"),e["boolean"]("restoreScroll")}}.call(this),function(){up.migrate.handleLayerOptions=function(e){var t,r,a,n;for(up.migrate.fixKey(e,"flavor","mode"),up.migrate.fixKey(e,"closable","dismissable"),up.migrate.fixKey(e,"closeLabel","dismissLabel"),r=0,a=(n=["width","maxWidth","height"]).length;r<a;r++)e[t=n[r]]&&up.migrate.warn("Layer option { "+t+" } has been removed. Use { size } or { class } instead.");if(e.sticky&&up.migrate.warn("Layer option { sticky } has been removed. Give links an [up-peel=false] attribute to prevent layer dismissal on click."),e.template&&up.migrate.warn("Layer option { template } has been removed. Use { class } or modify the layer HTML on up:layer:open."),"page"===e.layer&&(up.migrate.warn("Option { layer: 'page' } has been renamed to { layer: 'root' }."),e.layer="root"),"modal"===e.layer\|\|"popup"===e.layer)return up.migrate.warn("Option { layer: '"+e.layer+"' } has been removed. Did you mean { layer: 'overlay' }?"),e.layer="overlay"},up.migrate.handleTetherOptions=function(e){var t,r,a;if(r=(a=e.position.split("-"))[0],t=a[1])return up.migrate.warn("The position value %o is deprecated. Use %o instead.",e.position,{position:r,align:t}),e.position=r,e.align=t},up.migrate.registerLayerCloser=function(r){return r.registerClickCloser("up-close",function(e,t){return up.migrate.deprecated("[up-close]","[up-dismiss]"),r.dismiss(e,t)})},up.migrate.handleLayerConfig=function(e){return up.migrate.fixKey(e,"history","historyVisible")}}.call(this),function(){var e,a;a=up.util,e=new Error("up.modal.flavors has been removed without direct replacement. You may give new layers a { class } or modify layer elements on up:layer:open."),up.modal=a.literal({visit:function(e,t){return null==t&&(t={}),up.migrate.deprecated("up.modal.visit(url)",'up.layer.open({ url, mode: "modal" })'),up.layer.open(a.merge(t,{url:e,mode:"modal"}))},follow:function(e,t){return null==t&&(t={}),up.migrate.deprecated("up.modal.follow(link)",'up.follow(link, { layer: "modal" })'),up.follow(e,a.merge(t,{layer:"modal"}))},extract:function(e,t,r){return null==r&&(r={}),up.migrate.deprecated("up.modal.extract(target, document)",'up.layer.open({ document, mode: "modal" })'),up.layer.open(a.merge(r,{target:e,html:t,layer:"modal"}))},close:function(e){return null==e&&(e={}),up.migrate.deprecated("up.modal.close()","up.layer.dismiss()"),up.layer.dismiss(null,e),up.migrate.formerlyAsync("up.layer.dismiss()")},url:function(){return up.migrate.deprecated("up.modal.url()","up.layer.location"),up.layer.location},coveredUrl:function(){var e;return up.migrate.deprecated("up.modal.coveredUrl()","up.layer.parent.location"),null!=(e=up.layer.parent)?e.location:void 0},get_config:function(){return up.migrate.deprecated("up.modal.config","up.layer.config.modal"),up.layer.config.modal},contains:function(e){return up.migrate.deprecated("up.modal.contains()","up.layer.contains()"),up.layer.contains(e)},isOpen:function(){return up.migrate.deprecated("up.modal.isOpen()","up.layer.isOverlay()"),up.layer.isOverlay()},get_flavors:function(){throw e},flavor:function(){throw e}}),up.migrate.renamedEvent("up:modal:open","up:layer:open"),up.migrate.renamedEvent("up:modal:opened","up:layer:opened"),up.migrate.renamedEvent("up:modal:close","up:layer:dismiss"),up.migrate.renamedEvent("up:modal:closed","up:layer:dismissed"),up.link.targetMacro("up-modal",{"up-layer":"new modal"},function(){return up.migrate.deprecated("a[up-modal]",'a[up-layer="new modal"]')}),up.link.targetMacro("up-drawer",{"up-layer":"new drawer"},function(){return up.migrate.deprecated("a[up-drawer]",'a[up-layer="new drawer"]')})}.call(this),function(){var r;r=up.util,up.element,up.popup=r.literal({attach:function(e,t){return null==t&&(t={}),e=up.fragment.get(e),up.migrate.deprecated("up.popup.attach(origin)","up.layer.open({ origin, layer: 'popup' })"),up.layer.open(r.merge(t,{origin:e,layer:"popup"}))},close:function(e){return null==e&&(e={}),up.migrate.deprecated("up.popup.close()","up.layer.dismiss()"),up.layer.dismiss(null,e)},url:function(){return up.migrate.deprecated("up.popup.url()","up.layer.location"),up.layer.location},coveredUrl:function(){var e;return up.migrate.deprecated("up.popup.coveredUrl()","up.layer.parent.location"),null!=(e=up.layer.parent)?e.location:void 0},get_config:function(){return up.migrate.deprecated("up.popup.config","up.layer.config.popup"),up.layer.config.popup},contains:function(e){return up.migrate.deprecated("up.popup.contains()","up.layer.contains()"),up.layer.contains(e)},isOpen:function(){return up.migrate.deprecated("up.popup.isOpen()","up.layer.isOverlay()"),up.layer.isOverlay()},sync:function(){return up.migrate.deprecated("up.popup.sync()","up.layer.sync()"),up.layer.sync()}}),up.migrate.renamedEvent("up:popup:open","up:layer:open"),up.migrate.renamedEvent("up:popup:opened","up:layer:opened"),up.migrate.renamedEvent("up:popup:close","up:layer:dismiss"),up.migrate.renamedEvent("up:popup:closed","up:layer:dismissed"),up.link.targetMacro("up-popup",{"up-layer":"new popup"},function(){return up.migrate.deprecated("[up-popup]",'[up-layer="new popup"]')})}.call(this),function(){up.tooltip=up.macro("[up-tooltip]",function(e){return up.migrate.warn("[up-tooltip] has been deprecated. A [title] was set instead."),up.element.setMissingAttr(e,"title",e.getAttribute("up-tooltip"))})}.call(this),function(){var t,r,a=[].slice;r=up.util,up.migrate.renamedPackage("proxy","network"),up.migrate.renamedEvent("up:proxy:load","up:request:load"),up.migrate.renamedEvent("up:proxy:received","up:request:loaded"),up.migrate.renamedEvent("up:proxy:loaded","up:request:loaded"),up.migrate.renamedEvent("up:proxy:fatal","up:request:fatal"),up.migrate.renamedEvent("up:proxy:aborted","up:request:aborted"),up.migrate.renamedEvent("up:proxy:slow","up:request:late"),up.migrate.renamedEvent("up:proxy:recover","up:request:recover"),t=function(){return up.migrate.deprecated("up.proxy.config.preloadDelay","up.link.config.preloadDelay")},Object.defineProperty(up.network.config,"preloadDelay",{get:function(){return t(),up.link.config.preloadDelay},set:function(e){return t(),up.link.config.preloadDelay=e}}),up.migrate.renamedProperty(up.network.config,"maxRequests","concurrency"),up.migrate.renamedProperty(up.network.config,"slowDelay","badResponseTime"),up.migrate.handleNetworkPreloadArgs=function(){var e,t;if(e=1<=arguments.length?a.call(arguments,0):[],r.isElementish(e[0]))return up.migrate.warn("up.proxy.preload(link) has been renamed to up.link.preload(link)"),(t=up.link).preload.apply(t,e)},up.migrate.handleRequestOptions=function(e){return up.migrate.fixKey(e,"data","params")},up.ajax=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.deprecated("up.ajax()","up.request()"),t=function(e){return e.text},up.request.apply(up,e).then(t)},up.network.clear=function(){return up.migrate.deprecated("up.proxy.clear()","up.cache.clear()"),up.cache.clear()},up.Request.prototype.navigate=function(){return up.migrate.deprecated("up.Request#navigate()","up.Request#loadPage()"),this.loadPage()},up.Response.prototype.isSuccess=function(){return up.migrate.deprecated("up.Response#isSuccess()","up.Response#ok"),this.ok},up.Response.prototype.isError=function(){return up.migrate.deprecated("up.Response#isError()","!up.Response#ok"),!this.ok}}.call(this),function(){up.migrate.renamedProperty(up.radio.config,"hungry","hungrySelectors")}.call(this),function(){var o;o=up.util,up.migrate.postCompile=function(e,t){var r,a,n,u,p,i;if(n=t.keep){for(up.migrate.warn("The { keep: true } option for up.compiler() has been removed. Have the compiler set [up-keep] attribute instead."),i=o.isString(n)?n:"",p=[],a=0,u=e.length;a<u;a++)r=e[a],p.push(r.setAttribute("up-keep",i));return p}}}.call(this),function(){var r=[].slice;up.migrate.renamedPackage("layout","viewport"),up.migrate.renamedProperty(up.viewport.config,"viewports","viewportSelectors"),up.migrate.renamedProperty(up.viewport.config,"snap","revealSnap"),up.viewport.closest=function(){var e,t;return e=1<=arguments.length?r.call(arguments,0):[],up.migrate.deprecated("up.viewport.closest()","up.viewport.get()"),(t=up.viewport).get.apply(t,e)}}.call(this),function(){up.framework.stopExtension()}.call(this),function(){}.call(this);
1	+ (function(){up.framework.startExtension()}).call(this),function(){var u,p,e,t,r,a,n,i,o,l,c,s,d,m,g=[].slice;u=up.util,up.migrate=(p=new up.Config(function(){return{logLevel:"warn"}}),c=function(e,t,r){var a;return a=function(){return d("Property { %s } has been renamed to { %s } (found in %o)",t,r,e)},Object.defineProperty(e,t,{get:function(){return a(),this[r]},set:function(e){return a(),this[r]=e}})},a=function(e,t,r){if(u.isDefined(e[t]))return d("Property { %s } has been renamed to { %s } (found in %o)",t,r,e),u.renameKey(e,t,r)},o={},i=function(e,t){return o[e]=t},t=function(e){var t;return(t=o[e])?(d("Event "+e+" has been renamed to "+t),t):e},r=function(e){return u.uniq(u.map(e,t))},l=function(e,t){return Object.defineProperty(up,e,{get:function(){return d("up."+e+" has been renamed to up."+t),up[t]}})},m={},d=function(e){var t,r,a,n;if(a=e,t=2<=arguments.length?g.call(arguments,1):[],r=u.sprintf.apply(u,[a].concat(g.call(t))),!m[r])return m[r]=!0,(n=up.log)[p.logLevel].apply(n,["DEPRECATION",a].concat(g.call(t)))},e=function(e,t){return d(e+" has been deprecated. Use "+t+" instead.")},n=function(e){var t,r;return r=Promise.resolve(),t=r.then,r.then=function(){return d(e+" is now a sync function"),t.apply(this,arguments)},r},s=function(){return p.reset()},up.on("up:framework:reset",s),{deprecated:e,renamedPackage:l,renamedProperty:c,formerlyAsync:n,renamedEvent:i,fixEventTypes:r,fixKey:a,warn:d,loaded:!0,config:p})}.call(this),function(){var a=[].slice;up.util.only=function(e){var t,r;return r=e,t=2<=arguments.length?a.call(arguments,1):[],up.migrate.deprecated("up.util.only(object, ...keys)","up.util.pick(object, keys)"),up.util.pick(r,t)},up.util.except=function(e){var t,r;return r=e,t=2<=arguments.length?a.call(arguments,1):[],up.migrate.deprecated("up.util.except(object, ...keys)","up.util.omit(object, keys)"),up.util.omit(r,t)},up.util.parseUrl=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.parseUrl() has been renamed to up.util.parseURL()"),(t=up.util).parseURL.apply(t,e)},up.util.any=function(){var e;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.any() has been renamed to up.util.some()"),some.apply(null,e)},up.util.all=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.all() has been renamed to up.util.every()"),(t=up.util).every.apply(t,e)},up.util.detect=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.detect() has been renamed to up.util.find()"),(t=up.util).find.apply(t,e)},up.util.select=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.select() has been renamed to up.util.filter()"),(t=up.util).filter.apply(t,e)},up.util.setTimer=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.setTimer() has been renamed to up.util.timer()"),(t=up.util).timer.apply(t,e)},up.util.escapeHtml=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.deprecated("up.util.escapeHtml","up.util.escapeHTML"),(t=up.util).escapeHTML.apply(t,e)},up.util.selectorForElement=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.selectorForElement() has been renamed to up.fragment.toTarget()"),(t=up.fragment).toTarget.apply(t,e)},up.util.nextFrame=function(){var e,t;return e=1<=arguments.length?a.call(arguments,0):[],up.migrate.warn("up.util.nextFrame() has been renamed to up.util.task()"),(t=up.util).task.apply(t,e)}}.call(this),function(){var r=[].slice;up.element.first=function(){var e,t;return e=1<=arguments.length?r.call(arguments,0):[],up.migrate.deprecated("up.element.first()","up.element.get()"),(t=up.element).get.apply(t,e)},up.element.createFromHtml=function(){var e,t;return e=1<=arguments.length?r.call(arguments,0):[],up.migrate.deprecated("up.element.createFromHtml","up.element.createFromHTML"),(t=up.element).createFromHTML.apply(t,e)}}.call(this),function(){var t=[].slice;up.migrate.renamedPackage("bus","event"),up.event.nobodyPrevents=function(){var e;return e=1<=arguments.length?t.call(arguments,0):[],up.migrate.deprecated("up.event.nobodyPrevents(type)","!up.emit(type).defaultPrevented"),!up.emit.apply(up,e).defaultPrevented}}.call(this),function(){var o;o=up.util,up.migrate.postCompile=function(e,t){var r,a,n,u,p,i;if(n=t.keep){for(up.migrate.warn("The { keep: true } option for up.compiler() has been removed. Have the compiler set [up-keep] attribute instead."),i=o.isString(n)?n:"",p=[],a=0,u=e.length;a<u;a++)r=e[a],p.push(r.setAttribute("up-keep",i));return p}},up.migrate.targetMacro=function(n,u,p){return up.macro("["+n+"]",function(t){var r,a;return a=o.copy(u),(r=t.getAttribute(n))?a["up-target"]=r:a["up-follow"]="",e.setMissingAttrs(t,a),t.removeAttribute(n),"function"==typeof p?p():void 0})}}.call(this),function(){up.migrate.renamedProperty(up.form.config,"fields","fieldSelectors"),up.migrate.renamedProperty(up.form.config,"submitButtons","submitButtonSelectors")}.call(this),function(){var p,r=[].slice;p=up.util,up.migrate.renamedPackage("flow","fragment"),up.migrate.renamedPackage("dom","fragment"),up.migrate.renamedProperty(up.fragment.config,"fallbacks","mainTargets"),up.migrate.handleResponseDocOptions=function(e){return up.migrate.fixKey(e,"html","document")},up.replace=function(e,t,r){return up.migrate.deprecated("up.replace(target, url)","up.navigate(target, { url })"),up.navigate(p.merge(r,{target:e,url:t}))},up.extract=function(e,t,r){return up.migrate.deprecated("up.extract(target, document)","up.navigate(target, { document })"),up.navigate(p.merge(r,{target:e,document:t}))},up.fragment.first=function(){var e,t;return e=1<=arguments.length?r.call(arguments,0):[],up.migrate.deprecated("up.fragment.first()","up.fragment.get()"),(t=up.fragment).get.apply(t,e)},up.first=up.fragment.first,up.migrate.handleScrollOptions=function(e){if(p.isUndefined(e.scroll)&&(p.isString(e.reveal)?(up.migrate.deprecated("Option { reveal: '"+e.reveal+"' }","{ scroll: '"+e.reveal+"' }"),e.scroll=e.reveal):!0===e.reveal?(up.migrate.deprecated("Option { reveal: true }","{ scroll: 'target' }"),e.scroll="target"):!1===e.reveal&&(up.migrate.deprecated("Option { reveal: false }","{ scroll: false }"),e.scroll=!1),p.isDefined(e.resetScroll)&&(up.migrate.deprecated("Option { resetScroll: true }","{ scroll: 'reset' }"),e.scroll="teset"),p.isDefined(e.restoreScroll)))return up.migrate.deprecated("Option { restoreScroll: true }","{ scroll: 'restore' }"),e.scroll="restore"},up.migrate.handleHistoryOption=function(e){if(p.isString(e.history)&&"auto"!==e.history)return up.migrate.warn("Passing a URL as { history } option is deprecated. Pass it as { location } instead."),e.location=e.history,e.history="auto"},up.migrate.handleRenderOptions=function(e){var t,r,a,n,u;for(up.migrate.handleHistoryOption(e),u=[],t=0,r=(n=["target","origin"]).length;t<r;t++)a=n[t],p.isJQuery(e[a])?(up.migrate.warn("Passing a jQuery collection as { %s } is deprecated. Pass it as a native element instead.",a),u.push(e[a]=up.element.get(e[a]))):u.push(void 0);return u}}.call(this),function(){up.migrate.renamedProperty(up.history.config,"popTargets","restoreTargets"),up.history.url=function(){return up.migrate.deprecated("up.history.url()","up.history.location"),up.history.location},up.migrate.renamedEvent("up:history:push","up:location:changed"),up.migrate.renamedEvent("up:history:pushed","up:location:changed"),up.migrate.renamedEvent("up:history:restore","up:location:changed"),up.migrate.renamedEvent("up:history:restored","up:location:changed"),up.migrate.renamedEvent("up:history:replaced","up:location:changed")}.call(this),function(){up.migrate.renamedPackage("navigation","feedback"),up.migrate.renamedProperty(up.feedback.config,"navs","navSelectors")}.call(this),function(){up.migrate.parseFollowOptions=function(e){return e.string("flavor"),e.string("width"),e.string("height"),e["boolean"]("closable"),e.booleanOrString("reveal"),e["boolean"]("resetScroll"),e["boolean"]("restoreScroll")},up.migrate.targetMacro("up-dash",{"up-preload":"","up-instant":""},function(){return up.migrate.deprecated("a[up-dash]","up.link.config.instantSelectors or up.link.config.preloadSelectors")})}.call(this),function(){up.migrate.handleLayerOptions=function(e){var t,r,a,n;for(up.migrate.fixKey(e,"flavor","mode"),up.migrate.fixKey(e,"closable","dismissable"),up.migrate.fixKey(e,"closeLabel","dismissLabel"),r=0,a=(n=["width","maxWidth","height"]).length;r<a;r++)e[t=n[r]]&&up.migrate.warn("Layer option { "+t+" } has been removed. Use { size } or { class } instead.");if(e.sticky&&up.migrate.warn("Layer option { sticky } has been removed. Give links an [up-peel=false] attribute to prevent layer dismissal on click."),e.template&&up.migrate.warn("Layer option { template } has been removed. Use { class } or modify the layer HTML on up:layer:open."),"page"===e.layer&&(up.migrate.warn("Option { layer: 'page' } has been renamed to { layer: 'root' }."),e.layer="root"),"modal"===e.layer\|\|"popup"===e.layer)return up.migrate.warn("Option { layer: '"+e.layer+"' } has been removed. Did you mean { layer: 'overlay' }?"),e.layer="overlay"},up.migrate.handleTetherOptions=function(e){var t,r,a;if(r=(a=e.position.split("-"))[0],t=a[1])return up.migrate.warn("The position value %o is deprecated. Use %o instead.",e.position,{position:r,align:t}),e.position=r,e.align=t},up.migrate.registerLayerCloser=function(r){return r.registerClickCloser("up-close",function(e,t){return up.migrate.deprecated("[up-close]","[up-dismiss]"),r.dismiss(e,t)})},up.migrate.handleLayerConfig=function(e){return up.migrate.fixKey(e,"history","historyVisible")}}.call(this),function(){var e,a;a=up.util,e=new Error("up.modal.flavors has been removed without direct replacement. You may give new layers a { class } or modify layer elements on up:layer:open."),up.modal=a.literal({visit:function(e,t){return null==t&&(t={}),up.migrate.deprecated("up.modal.visit(url)",'up.layer.open({ url, mode: "modal" })'),up.layer.open(a.merge(t,{url:e,mode:"modal"}))},follow:function(e,t){return null==t&&(t={}),up.migrate.deprecated("up.modal.follow(link)",'up.follow(link, { layer: "modal" })'),up.follow(e,a.merge(t,{layer:"modal"}))},extract:function(e,t,r){return null==r&&(r={}),up.migrate.deprecated("up.modal.extract(target, document)",'up.layer.open({ document, mode: "modal" })'),up.layer.open(a.merge(r,{target:e,html:t,layer:"modal"}))},close:function(e){return null==e&&(e={}),up.migrate.deprecated("up.modal.close()","up.layer.dismiss()"),up.layer.dismiss(null,e),up.migrate.formerlyAsync("up.layer.dismiss()")},url:function(){return up.migrate.deprecated("up.modal.url()","up.layer.location"),up.layer.location},coveredUrl:function(){var e;return up.migrate.deprecated("up.modal.coveredUrl()","up.layer.parent.location"),null!=(e=up.layer.parent)?e.location:void 0},get_config:function(){return up.migrate.deprecated("up.modal.config","up.layer.config.modal"),up.layer.config.modal},contains:function(e){return up.migrate.deprecated("up.modal.contains()","up.layer.contains()"),up.layer.contains(e)},isOpen:function(){return up.migrate.deprecated("up.modal.isOpen()","up.layer.isOverlay()"),up.layer.isOverlay()},get_flavors:function(){throw e},flavor:function(){throw e}}),up.migrate.renamedEvent("up:modal:open","up:layer:open"),up.migrate.renamedEvent("up:modal:opened","up:layer:opened"),up.migrate.renamedEvent("up:modal:close","up:layer:dismiss"),up.migrate.renamedEvent("up:modal:closed","up:layer:dismissed"),up.migrate.targetMacro("up-modal",{"up-layer":"new modal"},function(){return up.migrate.deprecated("a[up-modal]",'a[up-layer="new modal"]')}),up.migrate.targetMacro("up-drawer",{"up-layer":"new drawer"},function(){return up.migrate.deprecated("a[up-drawer]",'a[up-layer="new drawer"]')})}.call(this),function(){var r;r=up.util,up.element,up.popup=r.literal({attach:function(e,t){return null==t&&(t={}),e=up.fragment.get(e),up.migrate.deprecated("up.popup.attach(origin)","up.layer.open({ origin, layer: 'popup' })"),up.layer.open(r.merge(t,{origin:e,layer:"popup"}))},close:function(e){return null==e&&(e={}),up.migrate.deprecated("up.popup.close()","up.layer.dismiss()"),up.layer.dismiss(null,e)},url:function(){return up.migrate.deprecated("up.popup.url()","up.layer.location"),up.layer.location},coveredUrl:function(){var e;return up.migrate.deprecated("up.popup.coveredUrl()","up.layer.parent.location"),null!=(e=up.layer.parent)?e.location:void 0},get_config:function(){return up.migrate.deprecated("up.popup.config","up.layer.config.popup"),up.layer.config.popup},contains:function(e){return up.migrate.deprecated("up.popup.contains()","up.layer.contains()"),up.layer.contains(e)},isOpen:function(){return up.migrate.deprecated("up.popup.isOpen()","up.layer.isOverlay()"),up.layer.isOverlay()},sync:function(){return up.migrate.deprecated("up.popup.sync()","up.layer.sync()"),up.layer.sync()}}),up.migrate.renamedEvent("up:popup:open","up:layer:open"),up.migrate.renamedEvent("up:popup:opened","up:layer:opened"),up.migrate.renamedEvent("up:popup:close","up:layer:dismiss"),up.migrate.renamedEvent("up:popup:closed","up:layer:dismissed"),up.link.targetMacro("up-popup",{"up-layer":"new popup"},function(){return up.migrate.deprecated("[up-popup]",'[up-layer="new popup"]')})}.call(this),function(){up.tooltip=up.macro("[up-tooltip]",function(e){return up.migrate.warn("[up-tooltip] has been deprecated. A [title] was set instead."),up.element.setMissingAttr(e,"title",e.getAttribute("up-tooltip"))})}.call(this),function(){var t,r=[].slice;up.util,up.migrate.renamedPackage("proxy","network"),up.migrate.renamedEvent("up:proxy:load","up:request:load"),up.migrate.renamedEvent("up:proxy:received","up:request:loaded"),up.migrate.renamedEvent("up:proxy:loaded","up:request:loaded"),up.migrate.renamedEvent("up:proxy:fatal","up:request:fatal"),up.migrate.renamedEvent("up:proxy:aborted","up:request:aborted"),up.migrate.renamedEvent("up:proxy:slow","up:request:late"),up.migrate.renamedEvent("up:proxy:recover","up:request:recover"),t=function(){return up.migrate.deprecated("up.proxy.config.preloadDelay","up.link.config.preloadDelay")},Object.defineProperty(up.network.config,"preloadDelay",{get:function(){return t(),up.link.config.preloadDelay},set:function(e){return t(),up.link.config.preloadDelay=e}}),up.migrate.renamedProperty(up.network.config,"maxRequests","concurrency"),up.migrate.renamedProperty(up.network.config,"slowDelay","badResponseTime"),up.migrate.handleRequestOptions=function(e){return up.migrate.fixKey(e,"data","params")},up.ajax=function(){var e,t;return e=1<=arguments.length?r.call(arguments,0):[],up.migrate.deprecated("up.ajax()","up.request()"),t=function(e){return e.text},up.request.apply(up,e).then(t)},up.network.clear=function(){return up.migrate.deprecated("up.proxy.clear()","up.cache.clear()"),up.cache.clear()},up.network.preload=function(){var e,t;return e=1<=arguments.length?r.call(arguments,0):[],up.migrate.deprecated("up.proxy.preload(link)","up.link.preload(link)"),(t=up.link).preload.apply(t,e)},up.Request.prototype.navigate=function(){return up.migrate.deprecated("up.Request#navigate()","up.Request#loadPage()"),this.loadPage()},up.Response.prototype.isSuccess=function(){return up.migrate.deprecated("up.Response#isSuccess()","up.Response#ok"),this.ok},up.Response.prototype.isError=function(){return up.migrate.deprecated("up.Response#isError()","!up.Response#ok"),!this.ok}}.call(this),function(){up.migrate.renamedProperty(up.radio.config,"hungry","hungrySelectors")}.call(this),function(){var r=[].slice;up.migrate.renamedPackage("layout","viewport"),up.migrate.renamedProperty(up.viewport.config,"viewports","viewportSelectors"),up.migrate.renamedProperty(up.viewport.config,"snap","revealSnap"),up.viewport.closest=function(){var e,t;return e=1<=arguments.length?r.call(arguments,0):[],up.migrate.deprecated("up.viewport.closest()","up.viewport.get()"),(t=up.viewport).get.apply(t,e)}}.call(this),function(){up.framework.stopExtension()}.call(this),function(){}.call(this);

data/dist/unpoly.js CHANGED Viewed

@@ -5,7 +5,7 @@
 (function() {
   window.up = {
-    version: "2.0.0-rc11"
+    version: "2.0.0"
   };
 }).call(this);
@@ -1259,6 +1259,7 @@ to not include another library in your asset bundle.
     @function up.util.last
     @param {Array<T>} array
     @return {T}
+    @stable
      */
     last = function(array) {
       return array[array.length - 1];
@@ -1572,24 +1573,24 @@ to not include another library in your asset bundle.
     };
     /***
-     * Registers an empty rejection handler with the given promise.
-     * This prevents browsers from printing "Uncaught (in promise)" to the error
-     * console when the promise is rejected.
-     *
-     * This is helpful for event handlers where it is clear that no rejection
-     * handler will be registered:
-     *
-     *     up.on('submit', 'form[up-target]', (event, $form) => {
-     *       promise = up.submit($form)
-     *       up.util.muteRejection(promise)
-     *     })
-     *
-     * Does nothing if passed a missing value.
-     *
-     * @function up.util.muteRejection
-     * @param {Promise|undefined|null} promise
-     * @return {Promise}
-     * @internal
+    Registers an empty rejection handler with the given promise.
+    This prevents browsers from printing "Uncaught (in promise)" to the error
+    console when the promise is rejected.
+    This is helpful for event handlers where it is clear that no rejection
+    handler will be registered:
+        up.on('submit', 'form[up-target]', (event, $form) => {
+          promise = up.submit($form)
+          up.util.muteRejection(promise)
+        })
+    Does nothing if passed a missing value.
+    @function up.util.muteRejection
+    @param {Promise|undefined|null} promise
+    @return {Promise}
+    @internal
      */
     muteRejection = function(promise) {
       return promise != null ? promise["catch"](noop) : void 0;
@@ -2145,10 +2146,12 @@ Chrome, Firefox, Edge, Safari
 : Full support
 Internet Explorer 11
-: Full support with a `Promise` polyfill like [es6-promise](https://github.com/stefanpenner/es6-promise) (2.4 KB).
+: Full support with a `Promise` polyfill like [es6-promise](https://github.com/stefanpenner/es6-promise) (2.4 KB).\
+  Support may be removed when Microsoft retires IE11 in [June 2022](https://blogs.windows.com/windowsexperience/2021/05/19/the-future-of-internet-explorer-on-windows-10-is-in-microsoft-edge/).
 Internet Explorer 10 or lower
-: Unpoly prevents itself from booting itself, leaving you with a classic server-side application.
+: Unpoly will not boot or [run compilers](/up.compiler),
+  leaving you with a classic server-side application.
 @module up.browser
  */
@@ -2161,7 +2164,9 @@ Internet Explorer 10 or lower
     u = up.util;
     /***
-    Makes a full page request, replacing the entire JavaScript environment with a new page from the server response.
+    Makes a full-page request, replacing the entire browser environment with a new page from the server response.
+    Also see `up.Request#loadPage()`.
     @function up.browser.loadPage
     @param {string} options.url
@@ -2171,7 +2176,7 @@ Internet Explorer 10 or lower
       Methods other than GET or POST will be [wrapped](/up.protocol.config#config.methodParam) in a POST request.
     @param {Object|Array|FormData|string} [options.params]
-    @external
+    @experimental
      */
     loadPage = function(requestsAttrs) {
       return new up.Request(requestsAttrs).loadPage();
@@ -6300,8 +6305,12 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
   /***
   Each layer has an `up.Layer` instance.
-  Most functions in the `up.layer` (lowercase) package interact with the [current layer](/up.layer.current).
-  E.g. `up.layer.dismiss()` is a shortcut for `up.layer.current.dismiss()`.
+  Most functions in the `up.layer` package interact with the [current layer](/up.layer.current).
+  For example, `up.layer.dismiss()` is a shortcut for `up.layer.current.dismiss()`.
+  `up.layer.current` is set to the right layer in compilers and most events,
+  even if that layer is not the frontmost layer. E.g. if you're compiling a fragment for a background layer, `up.layer.current` will be
+  the background layer during compilation.
   @class up.Layer
    */
@@ -6334,6 +6343,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     @property up.Layer#historyVisible
     @param {boolean} historyVisible
+    @stable
      */
@@ -6425,7 +6435,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     [Closes this overlay](/closing-overlays) with an accepting intent,
     e.g. when a change was confirmed or when a value was selected.
-    To dismiss a layer without an accepting intent, use `up.Layer#dismiss()` instead.
+    To dismiss a layer *without* an accepting intent, use `up.Layer#dismiss()` instead.
     @function up.Layer#accept
     @param {any} [value]
@@ -6463,7 +6473,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
-    [Closes this overlay](/closing-overlays) without an accepting intent,
+    [Closes this overlay](/closing-overlays) *without* an accepting intent,
     e.g. when a "Cancel" button was clicked.
     To close an overlay with an accepting intent, use `up.Layer#accept()` instead.
@@ -6538,7 +6548,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
     Returns whether this layer is the [root layer](/up.layer.root).
-    @function up.Layer#isFront
+    @function up.Layer#isRoot
     @return {boolean}
     @stable
      */
@@ -6619,7 +6629,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     Returns `undefined` if this layer has not opened a child layer.
-    A layer can have at most one child layer. Opening an overlay on a layer with an exiisting child will
+    A layer can have at most one child layer. Opening an overlay on a layer with an existing child will
     first dismiss the existing child before replacing it with the new child.
     @property up.Layer#child
@@ -6635,6 +6645,10 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
     Returns an array of this layer's ancestor layers.
+    The array elements are ordered by distance to this layer.
+    The first element is this layer's direct parent. The last element
+    is the [root layer](/up.layer.root).
     @property up.Layer#ancestors
     @return {Array<up.Layer>} ancestors
     @stable
@@ -6650,6 +6664,10 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     Descendant layers are all layers that visually overlay this layer.
+    The array elements are ordered by distance to this layer.
+    The first element is this layer's direct child. The last element
+    is the [frontmost layer](/up.layer.front).
     @property up.Layer#descendants
     @return {Array<up.Layer>} descendants
     @stable
@@ -6746,27 +6764,43 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
         up.follow(overlayLink) // listener is not called
     @function up.Layer#on
     @param {string} types
       A space-separated list of event types to bind to.
-    @param {string} [selector]
+    @param {string|Function(): string} [selector]
       The selector of an element on which the event must be triggered.
       Omit the selector to listen to all events of the given type, regardless
       of the event target.
+      If the selector is not known in advance you may also pass a function
+      that returns the selector. The function is evaluated every time
+      an event with the given type is observed.
     @param {boolean} [options.passive=false]
       Whether to register a [passive event listener](https://developers.google.com/web/updates/2016/06/passive-event-listeners).
       A passive event listener may not call `event.preventDefault()`.
       This in particular may improve the frame rate when registering
       `touchstart` and `touchmove` events.
+    @param {boolean} [options.once=true]
+      Whether the listener should run at most once.
+      If `true` the listener will automatically be unbound
+      after the first invocation.
     @param {Function(event, [element], [data])} listener
       The listener function that should be called.
       The function takes the affected element as the second argument.
       If the element has an [`up-data`](/up-data) attribute, its value is parsed as JSON
       and passed as a third argument.
     @return {Function()}
       A function that unbinds the event listeners when called.
     @stable
      */
@@ -6781,13 +6815,12 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     Unbinds an event listener previously bound with `up.Layer#on()`.
     @function up.Layer#off
-    @param {Element|jQuery} [element=document]
     @param {string} events
-    @param {string} [selector]
+    @param {string|Function(): string} [selector]
     @param {Function(event, [element], [data])} listener
       The listener function to unbind.
-      Note that you must pass a reference to the exact same listener function
+      Note that you must pass a reference to the same function reference
       that was passed to `up.Layer#on()` earlier.
     @stable
      */
@@ -6959,9 +6992,9 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
     This layer's location URL.
-    If the [frontmost layer](/up.layer.front) does not have [visible history](/up.Layer.prototype.historyVisible),
+    If the layer has [no visible history](/up.Layer.prototype.historyVisible), this property
+    still returns the URL of the content in the overlay. In this case
     the browser's address bar will show the location of an ancestor layer.
-    This property will return the URL the layer would use if it had visible history.
     When this layer opens a child layer with visible history, the browser URL will change to the child
     layer's location. When the child layer is closed, this layer's location will be restored.
@@ -7284,7 +7317,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
       If the destruction is animated, the callback will run after the animation has finished.
     @return {Promise}
       A resolved promise.
-    @private
+    @internal
      */
     Overlay.prototype.destroyElements = function(options) {
@@ -7423,6 +7456,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
     @function up.Layer.OverlayWithViewport#openNow
     @param {Element} options.content
+    @internal
      */
     OverlayWithViewport.prototype.createElements = function(content) {
@@ -8936,6 +8970,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     @param {string} name
     @return {any}
       The value of the param with the given name.
+    @internal
      */
     Params.prototype.getFirst = function(name) {
@@ -8954,6 +8989,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     @param {string} name
     @return {Array}
       An array of all values with the given name.
+    @internal
      */
     Params.prototype.getAll = function(name) {
@@ -9301,7 +9337,15 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
   /***
-  Instances of `up.RenderResult` describe the effects of [rendering](/up.fragment).
+  Instances of `up.RenderResult` describe the effects of [rendering](/up.render).
+  It is returned by functions like `up.render()` or `up.navigate()`:
+  ```js
+  let result = await up.render('.target', content: 'foo')
+  console.log(result.fragments) // => [<div class="target">...</div>]
+  console.log(result.layer)     // => up.Layer.Root
+  ```
   @class up.RenderResult
    */
@@ -9352,17 +9396,18 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
   /***
-  Instances of `up.Request` normalizes properties of an [AJAX request](/up.request)
-  such as the requested URL, form parameters and HTTP method.
+  A normalized description of an [HTTP request](`up.request()`).
   You can queue a request using the `up.request()` method:
-      let request = up.request('/foo')
-      console.log(request.url)
+  ```js
+  let request = up.request('/foo')
+  console.log(request.url)
-      // A request object is also a promise for its response
-      let response = await request
-      console.log(response.text)
+  // A request object is also a promise for its response
+  let response = await request
+  console.log(response.text)
+  ```
   @class up.Request
    */
@@ -9501,6 +9546,8 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
     The [layer](/up.layer) targeted by this request.
+    Setting the `{ layer }` property will automatically derive `{ context }` and `{ mode }` properties.
     To prevent memory leaks, this property is removed shortly after the response is received.
     @property up.Request#layer
@@ -9512,6 +9559,8 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
     The [layer](/up.layer) targeted by this request in case the server responds with an [error code](/server-errors).
+    Setting the `{ failLayer }` property will automatically derive `{ failContext }` and `{ failMode }` properties.
     To prevent memory leaks, this property is removed shortly after the response is received.
     @property up.Request#failLayer
@@ -9637,7 +9686,8 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     Request.prototype.normalizeForCaching = function() {
       this.method = u.normalizeMethod(this.method);
       this.extractHashFromURL();
-      return this.transferParamsToURL();
+      this.transferParamsToURL();
+      return this.url = u.normalizeURL(this.url);
     };
     Request.prototype.evictExpensiveAttrs = function() {
@@ -9724,6 +9774,37 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
       });
     };
+    /***
+    Loads this request object as a full-page request, replacing the entire browser environment
+    with a new page from the server response.
+    The full-page request will be loaded with the [URL](/up.Request.prototype.url),
+    [method](/up.Request.prototype.method) and [params](/up.Request.prototype.params)
+    from this request object.
+    Properties that are not possible in a full-page request (such as custom HTTP headers)
+    will be ignored.
+    \#\#\# Example
+    ```javascript
+    let request = await up.request('/path')
+    try {
+      let response = await request('/path')
+    } catch (result) {
+      if (result.name === 'AbortError') {
+        console.log('Request was aborted.')
+      }
+    }
+    request.abort()
+    ```
+    @function up.Request#loadPage
+    @experimental
+     */
     Request.prototype.loadPage = function() {
       up.network.abort();
       return new up.Request.FormRenderer(this).buildAndSubmit();
@@ -10303,7 +10384,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
   /***
-  Instances of `up.Response` describe the server response to an [AJAX request](/up.request).
+  A response to an [HTTP request](`up.request()`).
   \#\#\# Example
@@ -11281,37 +11362,23 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
 Events
 ======
-This module contains functions to [build](/up.event.build), [dispatch](/up.emit) and [listen to](/up.on) DOM events.
+This module contains functions to [emit](/up.emit) and [observe](/up.on) DOM events.
-While the browser also ships with functions like [`Element#dispatchEvent()`](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/dispatchEvent)
-and [`Element#addEventListener()`](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener) to
-work with DOM events, you will find the functions in this module to be more convenient and feature-rich.
+While the browser also has built-in functions to work with events,
+you will find Unpoly's functions to be very concise and feature-rich.
 ## Events emitted by Unpoly
-Most Unpoly interactions emit DOM events that are prefixed with `up:`.
+Most Unpoly features emit events that are prefixed with `up:`.
-```javascript
-document.addEventListener('up:modal:opened', (event) => {
-  console.log('A new modal has just opened!')
-})
-```
+Unpoly's own events are documented in their respective modules, for example:
-Events often have both present and past forms. For example, `up:layer:open` is emitted before an overlay starts to open.
-`up:layer:opened` is emitted when the overlay has appeared in the DOM tree.
-\#\#\# Preventing events
-You can prevent most present form events by calling `preventDefault()`:
-```javascript
-document.addEventListener('up:modal:open', (event) => {
-  if (event.url == '/evil') {
-    // Prevent the modal from opening
-    event.preventDefault()
-  }
-})
-```
+| Event                 | Module             |
+|-----------------------|--------------------|
+| `up:link:follow`      | `up.link`          |
+| `up:form:submit`      | `up.form`          |
+| `up:layer:open`       | `up.layer`         |
+| `up:request:late`     | `up.network`       |
 @see up.on
 @see up.emit
@@ -11454,12 +11521,16 @@ document.addEventListener('up:modal:open', (event) => {
       Multiple event types may be passed as either a space-separated string
       or as an array of types.
-    @param {string} [selector]
+    @param {string|Function():string} [selector]
       The selector of an element on which the event must be triggered.
       Omit the selector to listen to all events of the given type, regardless
       of the event target.
+      If the selector is not known in advance you may also pass a function
+      that returns the selector. The function is evaluated every time
+      an event with the given type is observed.
     @param {boolean} [options.passive=false]
       Whether to register a [passive event listener](https://developers.google.com/web/updates/2016/06/passive-event-listeners).
@@ -11470,7 +11541,7 @@ document.addEventListener('up:modal:open', (event) => {
     @param {boolean} [options.once=true]
       Whether the listener should run at most once.
-      If `true` the listener will automatically be removed from the element
+      If `true` the listener will automatically be unbound
       after the first invocation.
     @param {Function(event, [element], [data])} listener
@@ -11561,12 +11632,12 @@ document.addEventListener('up:modal:open', (event) => {
     @function up.off
     @param {Element|jQuery} [element=document]
-    @param {string} events
+    @param {string|Function(): string} events
     @param {string} [selector]
     @param {Function(event, [element], [data])} listener
       The listener function to unbind.
-      Note that you must pass a reference to the exact same listener function
+      Note that you must pass a reference to the same function reference
       that was passed to `up.on()` earlier.
     @stable
      */
@@ -11817,7 +11888,7 @@ document.addEventListener('up:modal:open', (event) => {
     This hyperlink will emit an `user:select` event when clicked:
-    ```
+    ```html
     <a href='/users/5'
       up-emit='user:select'
       up-emit-props='{ "id": 5, "firstName": "Alice" }'>
@@ -12135,7 +12206,7 @@ There are existing implementations for various web frameworks:
     The time is encoded is the number of seconds elapsed since the [Unix epoch](https://en.wikipedia.org/wiki/Unix_time).
-    For instance, a modification date of December 24th, 1:51:46 PM UTC would produce the following header:
+    For instance, a modification date of December 23th, 1:40:18 PM UTC would produce the following header:
     ```http
     X-Up-Target: .unread-count
@@ -12376,7 +12447,7 @@ There are existing implementations for various web frameworks:
     the response's HTML content.
     The header value is the acceptance value serialized as a JSON object.
-    To accept an overlay without value, set the header value to `null`.
+    To accept an overlay without value, set the header value to the string `null`.
     \#\#\# Example
@@ -12422,7 +12493,7 @@ There are existing implementations for various web frameworks:
     the response's HTML content.
     The header value is the dismissal value serialized as a JSON object.
-    To accept an overlay without value, set the header value to `null`.
+    To accept an overlay without value, set the header value to the string `null`.
     \#\#\# Example
@@ -12647,13 +12718,14 @@ There are existing implementations for various web frameworks:
 Logging
 =======
-Unpoly can print debugging information to the developer console, e.g.:
+Unpoly can print debugging information to the [browser console](https://developer.chrome.com/docs/devtools/console/), e.g.:
 - Which [events](/up.event) are called
 - When we're [making requests to the network](/up.request)
 - Which [compilers](/up.syntax) are applied to which elements
-You can activate logging by calling [`up.log.enable()`](/up.log.enable).
+@see up.log.enable
+@see up.log.disable
 @module up.log
  */
@@ -12769,7 +12841,7 @@ You can activate logging by calling [`up.log.enable()`](/up.log.enable).
     };
     /***
-    Makes future Unpoly events print vast amounts of debugging information to the developer console.
+    Starts printing debugging information to the developer console.
     Debugging information includes which elements are being [compiled](/up.syntax)
     and which [events](/up.event) are being emitted.
@@ -12784,7 +12856,7 @@ You can activate logging by calling [`up.log.enable()`](/up.log.enable).
     };
     /***
-    Prevents future Unpoly events from printing vast amounts of debugging information to the developer console.
+    Stops printing debugging information to the developer console.
     Errors will still be printed, even with logging disabled.
@@ -12826,24 +12898,26 @@ You can activate logging by calling [`up.log.enable()`](/up.log.enable).
     };
     /***
-     * Registers an empty rejection handler in case the given promise
-     * rejects with an AbortError or a failed up.Response.
-     *
-     * This prevents browsers from printing "Uncaught (in promise)" to the error
-     * console when the promise is rejected.
-     *
-     * This is helpful for event handlers where it is clear that no rejection
-     * handler will be registered:
-     *
-     *     up.on('submit', 'form[up-target]', (event, form) => {
-     *       promise = up.submit(form)
-     *       up.util.muteRejection(promise)
-     *     })
-     *
-     * @function up.log.muteUncriticalRejection
-     * @param {Promise} promise
-     * @return {Promise}
-     * @internal
+    Registers an empty rejection handler in case the given promise
+    rejects with an AbortError or a failed up.Response.
+    This prevents browsers from printing "Uncaught (in promise)" to the error
+    console when the promise is rejected.
+    This is helpful for event handlers where it is clear that no rejection
+    handler will be registered:
+    ```js
+    up.on('submit', 'form[up-target]', (event, form) => {
+      promise = up.submit(form)
+      up.util.muteRejection(promise)
+    })
+    ```
+    @function up.log.muteUncriticalRejection
+    @param {Promise} promise
+    @return {Promise}
+    @internal
      */
     muteUncriticalRejection = function(promise) {
       return promise["catch"](function(error) {
@@ -13415,9 +13489,7 @@ The `up.syntax` package lets you pair HTML elements with JavaScript behavior.
 History
 ========
-In an Unpoly app, every page has an URL.
-[Fragment updates](/up.link) automatically update the URL.
+The `up.history` module helps you work with the browser history.
 @see up.history.location
 @see up:location:changed
@@ -13445,7 +13517,7 @@ In an Unpoly app, every page has an URL.
       Defines whether [fragment updates](/up.render) will update the browser's current URL.
       If set to `false` Unpoly will never change the browser URL.
-    @param {boolean} [config.restoreScroll=true]
+    @param {boolean} [config.enabled=true]
       Whether to restore the known scroll positions
       when the user goes back or forward in history.
     @stable
@@ -13554,7 +13626,7 @@ In an Unpoly app, every page has an URL.
     address bar with the given URL.
     When the user restores the new history entry later,
-    Unpoly will replace the document body with the body from that URL.
+    Unpoly will replace a selector from `up.history.config.restoreTargets` with the body from that URL.
     Note that [fragment navigation](/navigation) will automatically update the
     browser's location bar for you.
@@ -13588,7 +13660,7 @@ In an Unpoly app, every page has an URL.
     When a [layer](/up.layer) has no [visible history](/up.Layer.prototype.historyVisible), following a link
     will not cause the browser's address bar to be updated. In this case no `up:location:changed` event will be emitted.
-    There will however be an `up:layer:location:changed` event be emitted.
+    However, a `up:layer:location:changed` will be emitted even if the address bar did not change.
     @event up:location:changed
     @param {string} event.url
@@ -13752,7 +13824,7 @@ In an Unpoly app, every page has an URL.
   - As fragments enter the page they are automatically [compiled](/up.compiler) to activate JavaScript behavior.
   - Fragment changes may be [animated](/up.motion).
   - Fragments are placed on a [layer](/up.layer) that is isolated from other layers.
-    Unpoly functions will only see or change fragments from the [current layer](/up.layer.current)
+    Unpoly features will only see or change fragments from the [current layer](/up.layer.current)
     unless you [explicitly target another layer](/layer-option).
   - Fragments [know the URL from where they were loaded](/up.source).
     They can be [reloaded](/up.reload) or [polled periodically](/up-polled).
@@ -13815,7 +13887,7 @@ In an Unpoly app, every page has an URL.
       The default configuration tries, in this order:
       - If the URL has a `#hash`, scroll to the hash.
-      - If updating a [main target](/main), reset scroll positions.
+      - If updating a [main target](/up-main), reset scroll positions.
     @param {boolean|string|Function(Element)} [config.autoFocus]
       How to focus when updating a fragment with `{ focus: 'auto' }`.
@@ -13827,7 +13899,7 @@ In an Unpoly app, every page has an URL.
       - Focus a `#hash` in the URL.
       - Focus an `[autofocus]` element in the new fragment.
       - If focus was lost with the old fragment, focus the new fragment.
-      - If updating a [main target](/main), focus the new fragment.
+      - If updating a [main target](/up-main), focus the new fragment.
     @param {boolean} [config.runScripts=false]
       Whether to execute `<script>` tags in updated fragments.
@@ -13835,7 +13907,7 @@ In an Unpoly app, every page has an URL.
       Scripts will load asynchronously, with no guarantee of execution order.
       If you set this to `true`, mind that the `<body>` element is a default
-      [main target](/main). If you are including your global application scripts
+      [main target](/up-main). If you are including your global application scripts
       at the end of your `<body>`
       for performance reasons, swapping the `<body>` will re-execute these scripts.
       In that case you must configure a different main target that does not include
@@ -14018,7 +14090,7 @@ In an Unpoly app, every page has an URL.
     The current and new elements must both match the same CSS selector.
     The selector is either given as `{ target }` option,
-    or a [main target](/main) is used as default.
+    or a [main target](/up-main) is used as default.
     See the [fragment placement](/fragment-placement) selector for many examples for how you can target content.
@@ -14079,29 +14151,32 @@ In an Unpoly app, every page has an URL.
     @function up.render
-    @param {string|Element|jQuery} [target]
+    @param {string|Element|jQuery|Array<string>} [target]
       The CSS selector to update.
-      If omitted a [main target](/main) will be rendered.
+      If omitted a [main target](/up-main) will be rendered.
-      You can also pass a DOM element or jQuery element here, in which case a selector
+      You may also pass a DOM element or jQuery element here, in which case a selector
       will be [inferred from the element attributes](/up.fragment.toTarget). The given element
       will also be used as [`{ origin }`](#options.origin) for the fragment update.
+      You may also pass an array of selector alternatives. The first selector
+      matching in both old and new content will be used.
       Instead of passing the target as the first argument, you may also pass it as
       a [´{ target }`](#options.target) option..
-    @param {string|Element|jQuery} [options.target]
+    @param {string|Element|jQuery|Array<string>} [options.target]
       The CSS selector to update.
-      If omitted a [main target](/main) will be rendered.
+      See documentation for the [`target`](#target) parameter.
     @param {string|boolean} [options.fallback=false]
       Specifies behavior if the [target selector](/up.render#options.target) is missing from the current page or the server response.
       If set to a CSS selector string, Unpoly will attempt to replace that selector instead.
-      If set to `true` Unpoly will attempt to replace a [main target](/main) instead.
+      If set to `true` Unpoly will attempt to replace a [main target](/up-main) instead.
       If set to `false` Unpoly will immediately reject the render promise.
@@ -14181,7 +14256,7 @@ In an Unpoly app, every page has an URL.
       If set to `'auto'` history will be updated if the `{ target }` matches
       a selector in `up.fragment.config.autoHistoryTargets`. By default this contains all
-      [main targets](/main).
+      [main targets](/up-main).
       If set to `false`, the history will remain unchanged.
@@ -14237,11 +14312,12 @@ In an Unpoly app, every page has an URL.
       Also see [`up.request({ cache })`](/up.request#options.cache).
     @param {boolean|string} [options.clearCache]
-      Whether existing [cache](/up.cache) entries will be cleared with this request.
+      Whether existing [cache](/up.cache) entries will be [cleared](/up.cache.clear) with this request.
-      By default a non-GET request will clear the entire cache.
       You may also pass a [URL pattern](/url-patterns) to only clear matching requests.
+      By default a non-GET request will clear the entire cache.
       Also see [`up.request({ clearCache })`](/up.request#options.clearCache) and `up.network.config.clearCache`.
     @param {Element|jQuery} [options.origin]
@@ -14370,7 +14446,7 @@ In an Unpoly app, every page has an URL.
     @param {string|Element|jQuery} [target]
       The CSS selector to update.
-      If omitted a [main target](/main) will be rendered.
+      If omitted a [main target](/up-main) will be rendered.
       You can also pass a DOM element or jQuery element here, in which case a selector
       will be [inferred from the element attributes](/up.fragment.target). The given element
@@ -14400,17 +14476,19 @@ In an Unpoly app, every page has an URL.
     an entirely different page layout (like a maintenance page or fatal server error)
     which should be open with a full page load:
-        up.on('up:fragment:loaded', (event) => {
-          let isMaintenancePage = event.response.getHeader('X-Maintenance')
+    ```js
+    up.on('up:fragment:loaded', (event) => {
+      let isMaintenancePage = event.response.getHeader('X-Maintenance')
-          if (isMaintenancePage) {
-            // Prevent the fragment update and don't update browser history
-            event.preventDefault()
+      if (isMaintenancePage) {
+        // Prevent the fragment update and don't update browser history
+        event.preventDefault()
-            // Make a full page load for the same request.
-            event.request.loadPage()
-          }
-        })
+        // Make a full page load for the same request.
+        event.request.loadPage()
+      }
+    })
+    ```
     Instead of preventing the update, listeners may also access the `event.renderOptions` object
     to mutate options to the `up.render()` call that will process the server response.
@@ -14424,6 +14502,7 @@ In an Unpoly app, every page has an URL.
       The server response.
     @param {Object} event.renderOptions
       Options for the `up.render()` call that will process the server response.
+    @stable
      */
     /***
@@ -15123,9 +15202,10 @@ In an Unpoly app, every page has an URL.
     \#\#\# Example
-        element = document.createElement('span')
-        element.className = 'klass'
-        selector = up.fragment.toTarget(element) // returns '.klass'
+    ```js
+    element = up.element.createFromHTML('<span class="klass">...</span>')
+    selector = up.fragment.toTarget(element) // returns '.klass'
+    ```
     @function up.fragment.toTarget
     @param {string|Element|jQuery}
@@ -15300,10 +15380,13 @@ In an Unpoly app, every page has an URL.
     When no other render target is given, Unpoly will try to find and replace a main target.
     In most app layouts the main target should match the primary content area.
-    The default main targets are the HTML5 [`<main>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/main) element,
-    any element with an `[up-main]` attribute and the current layer's
-    [topmost swappable element](/main). You may configure main target selectors
-    in `up.fragment.config.mainTargets`.
+    The default main targets are:
+    - any element with an `[up-main]` attribute
+    - the HTML5 [`<main>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/main) element
+    - the current layer's [topmost swappable element](/layer)
+    You may configure main target selectors in `up.fragment.config.mainTargets`.
     \#\#\# Example
@@ -15315,6 +15398,86 @@ In an Unpoly app, every page has an URL.
     @experimental
      */
+    /***
+    Updates this element when no other render target is given.
+    \#\#\# Example
+    Many links simply replace the main content element in your application layout.
+    Unpoly lets you mark this elements as a default target using the `[up-main]` attribute:
+    ```html
+    <body>
+      <div class="layout">
+        <div class="layout--side">
+          ...
+        </div>
+        <div class="layout--content" up-main>
+          ...
+        </div>
+      </div>
+    </body>
+    ```
+    Once a main target is configured, you no longer need `[up-target]` in a link.\
+    Use `[up-follow]` and the `[up-main]` element will be replaced:
+    ```html
+    <a href="/foo" up-follow>...</a>
+    ```
+    If you want to update something more specific, you can still use `[up-target]`:
+    ```html
+    <a href="/foo" up-target=".profile">...</a>
+    ```
+    Instead of assigning `[up-main]` you may also configure an existing selector in `up.fragment.config.mainTargets`:
+    ```js
+    up.fragment.config.mainTargets.push('.layout--content')
+    ```
+    Overlays can use different main targets
+    ---------------------------------------
+    Overlays often use a different default selector, e.g. to exclude a navigation bar.
+    To define a different main target for an overlay, set the [layer mode](/layer-terminology) as the
+    value of the `[up-main]` attribute:
+    ```html
+    <body>
+      <div class="layout" up-main="root">
+        <div class="layout--side">
+          ...
+        </div>
+        <div class="layout--content" up-main="modal">
+          ...
+        </div>
+      </div>
+    </body>
+    ```
+    Instead of assigning `[up-main]` you may also configure layer-specific targets in `up.layer.config`:
+    ```js
+    up.layer.config.popup.mainTargets.push('.menu')              // for popup overlays
+    up.layer.config.drawer.mainTargets.push('.menu')             // for drawer overlays
+    up.layer.config.overlay.mainTargets.push('.layout--content') // for all overlay modes
+    ```
+    @selector [up-main]
+    @param [up-main]
+      A space-separated list of [layer modes](/layer-terminology) for which to use this main target.
+      Omit the attribute value to define a main target for *all* layer modes.
+      To use a different main target for all overlays (but not the root layer), set `[up-main=overlay]`.
+    @stable
+     */
     /***
     To make a server request without changing a fragment, use the `:none` selector.
@@ -15359,7 +15522,7 @@ In an Unpoly app, every page has an URL.
     For the [root layer](/up.layer.root) it is the `<body>` element. For an overlay
     it is the target with which the overlay was opened with.
-    In canonical usage the topmost swappable element is often a [main element](/main).
+    In canonical usage the topmost swappable element is often a [main element](/up-main).
     \#\#\# Example
@@ -16380,11 +16543,16 @@ Animation
 When you [update a page fragment](/up.link) you can animate the change.
-Let's say you are using an [`up-follow`](/a-up-follow) link to update an element
-with content from the server. You can add an attribute [`up-transition`](/a-up-follow#up-transition)
-to smoothly fade out the old element while fading in the new element:
+You can add an attribute [`[up-transition]`](/a-up-transition) to your
+links or forms to smoothly fade out the old element while fading in the new element:
-    <a href="/users" up-target=".list" up-transition="cross-fade">Show users</a>
+```html
+<a href="/users"
+  up-target=".list"
+  up-transition="cross-fade">
+  Show users
+</a>
+```
 \#\#\# Transitions vs. animations
@@ -16392,10 +16560,17 @@ When we morph between an old and a new element, we call it a *transition*.
 In contrast, when we animate a new element without simultaneously removing an
 old element, we call it an *animation*.
-An example for an animation is opening a new dialog. We can animate the appearance
-of the dialog by adding an [`[up-animation]`](/a-up-modal#up-animation) attribute to the opening link:
+An example for an animation is opening a new overlay. We can animate the appearance
+of the dialog by adding an [`[up-animation]`](/a-up-animation) attribute to the opening link:
-    <a href="/users" up-modal=".list" up-animation="move-from-top">Show users</a>
+```html
+<a href="/users"
+  up-target=".list"
+  up-layer="new"
+  up-animation="move-from-top">
+  Show users
+</a>
+```
 \#\#\# Which animations are available?
@@ -16405,17 +16580,16 @@ and [predefined animations](/up.animate#named-animations).
 You can define custom animations using `up.transition()` and
 `up.animation()`.
+@see a[up-transition]
 @see up.animation
-@see up.animate
 @see up.transition
-@see up.morph
 @module up.motion
  */
 (function() {
   up.motion = (function() {
-    var animate, animateNow, applyConfig, composeTransitionFn, config, e, findAnimationFn, findNamedAnimation, findTransitionFn, finish, isEnabled, isNone, morph, motionController, namedAnimations, namedTransitions, pickDefault, registerAnimation, registerMoveMotions, registerOpacityAnimation, registerTransition, reset, skipAnimate, swapElementsDirectly, translateCSS, u, untranslatedBox, warnIfDisabled, willAnimate;
+    var animate, animateNow, applyConfig, composeTransitionFn, config, e, findAnimationFn, findNamedAnimation, findTransitionFn, finish, isEnabled, isNone, morph, motionController, namedAnimations, namedTransitions, pickDefault, registerAnimation, registerMoveAnimations, registerOpacityAnimation, registerTransition, reset, skipAnimate, swapElementsDirectly, translateCSS, u, untranslatedBox, warnIfDisabled, willAnimate;
     u = up.util;
     e = up.element;
     namedAnimations = {};
@@ -16433,9 +16607,12 @@ You can define custom animations using `up.transition()` and
       See [W3C documentation](http://www.w3.org/TR/css3-transitions/#transition-timing-function)
       for a list of pre-defined timing functions.
-    @param {boolean} [config.enabled=true]
+    @param {boolean} [config.enabled]
       Whether animation is enabled.
+      By default animations are enabled, unless the user has configured their
+      system to [minimize non-essential motion](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-reduced-motion).
       Set this to `false` to disable animation globally.
       This can be useful in full-stack integration tests.
     @stable
@@ -16477,15 +16654,19 @@ You can define custom animations using `up.transition()` and
     \#\#\# Example
-        up.animate('.warning', 'fade-in')
+    ```js
+    up.animate('.warning', 'fade-in')
+    ```
     You can pass additional options:
-        up.animate('.warning', 'fade-in', {
-          delay: 1000,
-          duration: 250,
-          easing: 'linear'
-        })
+    ```
+    up.animate('.warning', 'fade-in', {
+      delay: 1000,
+      duration: 250,
+      easing: 'linear'
+    })
+    ```
     \#\#\# Named animations
@@ -16510,9 +16691,11 @@ You can define custom animations using `up.transition()` and
     By passing an object instead of an animation name, you can animate
     the CSS properties of the given element:
-        var warning = document.querySelector('.warning')
-        warning.style.opacity = 0
-        up.animate(warning, { opacity: 1 })
+    ```
+    var warning = document.querySelector('.warning')
+    warning.style.opacity = 0
+    up.animate(warning, { opacity: 1 })
+    ```
     CSS properties must be given in `kebab-case`, not `camelCase`.
@@ -16618,7 +16801,7 @@ You can define custom animations using `up.transition()` and
     Animations are completed by jumping to the last animation frame instantly.
     Promises returned by animation and transition functions instantly settle.
-    Emits the `up:motion:finish` event that is already handled by `up.animate()`.
+    Emits the `up:motion:finish` event that is handled by `up.animate()`.
     Does nothing if there are no animation to complete.
@@ -16816,18 +16999,20 @@ You can define custom animations using `up.transition()` and
     });
     /***
-    Defines a named transition that [morphs](/up.element) from one element to another.
+    Defines a named transition that [morphs](/up.morph) from one element to another.
     \#\#\# Example
     Here is the definition of the pre-defined `cross-fade` animation:
-        up.transition('cross-fade', (oldElement, newElement, options) ->
-          Promise.all([
-            up.animate(oldElement, 'fade-out', options),
-            up.animate(newElement, 'fade-in', options)
-          ])
-        )
+    ```js
+    up.transition('cross-fade', (oldElement, newElement, options) ->
+      Promise.all([
+        up.animate(oldElement, 'fade-out', options),
+        up.animate(newElement, 'fade-in', options)
+      ])
+    )
+    ```
     It is recommended that your transitions use [`up.animate()`](/up.animate),
     passing along the `options` that were passed to you.
@@ -16862,10 +17047,12 @@ You can define custom animations using `up.transition()` and
     Here is the definition of the pre-defined `fade-in` animation:
-        up.animation('fade-in', function(element, options) {
-          element.style.opacity = 0
-          up.animate(element, { opacity: 1 }, options)
-        })
+    ```js
+    up.animation('fade-in', function(element, options) {
+      element.style.opacity = 0
+      up.animate(element, { opacity: 1 }, options)
+    })
+    ```
     It is recommended that your definitions always end by calling
     calling [`up.animate()`](/up.animate) with an object argument, passing along
@@ -16933,7 +17120,7 @@ You can define custom animations using `up.transition()` and
       e.setStyle(element, translateCSS(0, 0));
       return element.getBoundingClientRect();
     };
-    registerMoveMotions = function(direction, boxToTransform) {
+    registerMoveAnimations = function(direction, boxToTransform) {
       var animationFromName, animationToName;
       animationToName = "move-to-" + direction;
       animationFromName = "move-from-" + direction;
@@ -16951,22 +17138,22 @@ You can define custom animations using `up.transition()` and
         return animateNow(element, translateCSS(0, 0), options);
       });
     };
-    registerMoveMotions('top', function(box) {
+    registerMoveAnimations('top', function(box) {
       var travelDistance;
       travelDistance = box.top + box.height;
       return translateCSS(0, -travelDistance);
     });
-    registerMoveMotions('bottom', function(box) {
+    registerMoveAnimations('bottom', function(box) {
       var travelDistance;
       travelDistance = up.viewport.rootHeight() - box.top;
       return translateCSS(0, travelDistance);
     });
-    registerMoveMotions('left', function(box) {
+    registerMoveAnimations('left', function(box) {
       var travelDistance;
       travelDistance = box.left + box.width;
       return translateCSS(-travelDistance, 0);
     });
-    registerMoveMotions('right', function(box) {
+    registerMoveAnimations('right', function(box) {
       var travelDistance;
       travelDistance = up.viewport.rootWidth() - box.left;
       return translateCSS(travelDistance, 0);
@@ -16981,10 +17168,17 @@ You can define custom animations using `up.transition()` and
     [Follows](/a-up-follow) this link and swaps in the new fragment
     with an animated transition.
+    Note that transitions are not possible when replacing the `body`
+    element.
     \#\#\# Example
     ```html
-    <a href="/page2" up-transition="move-left">Next page</a>
+    <a href="/page2"
+      up-target=".story"
+      up-transition="move-left">
+      Next page
+    </a>
     ```
     @selector a[up-transition]
@@ -16996,6 +17190,7 @@ You can define custom animations using `up.transition()` and
       The transition to use when the server responds with an error code.
       @see server-errors
+    @stable
      */
     /***
@@ -17005,7 +17200,9 @@ You can define custom animations using `up.transition()` and
     \#\#\# Example
     ```html
-    <form action="/tasks" up-transition="cross-fade">
+    <form action="/tasks"
+      up-target=".content"
+      up-transition="cross-fade">
       ...
     </form>
     ```
@@ -17019,6 +17216,7 @@ You can define custom animations using `up.transition()` and
       The transition to use when the server responds with an error code.
       @see server-errors
+    @stable
      */
     up.on('up:framework:boot', warnIfDisabled);
     up.on('up:framework:reset', reset);
@@ -17059,47 +17257,25 @@ You can define custom animations using `up.transition()` and
   Network requests
   ================
-  TODO: Rewrite this page
-  Unpoly comes with a number of tricks to shorten the latency between browser and server.
-  \#\#\# Server responses are cached by default
-  Unpoly caches server responses for a few minutes,
-  making requests to these URLs return instantly.
-  All Unpoly functions and selectors go through this cache, unless
-  you explicitly pass a `{ cache: false }` option or set an `up-cache="false"` attribute.
-  The cache holds up to 50 responses for 5 minutes. You can configure the cache size and expiry using
-  [`up.network.config`](/up.network.config), or clear the cache manually using [`up.cache.clear()`](/up.cache.clear).
-  Also the entire cache is cleared with every non-`GET` request (like `POST` or `PUT`).
-  If you need to make cache-aware requests from your [custom JavaScript](/up.syntax),
-  use [`up.request()`](/up.request).
-  \#\#\# Preloading links
-  Unpoly also lets you speed up reaction times by [preloading
-  links](/a-up-preload) when the user hovers over the click area (or puts the mouse/finger
-  down). This way the response will already be cached when
-  the user releases the mouse/finger.
+  Unpoly ships with an optimized HTTP client for fast and effective
+  communication with your server-side app.
-  \#\#\# Spinners
+  While you can use the browser's native `fetch()` function,
+  Unpoly's `up.request()` has a number of convenience features:
-  You can listen to the [`up:request:late`](/up:request:late) event to implement a spinner
-  that appears during a long-running request.
-  \#\#\# More acceleration
-  Other Unpoly modules contain even more tricks to outsmart network latency:
-  - [Instantaneous feedback for links that are currently loading](/a.up-active)
-  - [Follow links on `mousedown` instead of `click`](/a-up-instant)
+  - Requests may be [cached](/up.request#options.cache) to reuse responses and enable [preloading](/a-up-preload).
+  - Requests send [additional HTTP headers](/up.protocol) that the server may use to optimize its response.
+    For example, when updating a [fragment](/up.fragment), the fragment's selector is automatically sent
+    as an `X-Up-Target` header. The server may choose to only render the targeted fragment.
+  - Useful events like `up:request:loaded` or `up:request:late` are emitted throughout the request/response
+    lifecycle.
+  - When too many requests are sent concurrently, excessive requests are [queued](/up.network.config#config.concurrency).
+    This prevents exhausting the user's bandwidth and limits race conditions in end-to-end tests.
+  - A very concise API requiring zero boilerplate code.
   @see up.request
-  @see up.Request
   @see up.Response
+  @see up:request:late
   @module up.network
    */
@@ -17117,8 +17293,8 @@ You can define custom animations using `up.transition()` and
       Additional requests are queued. [Preload](/a-up-preload) requests are
       always queued behind non-preload requests.
-      You might find it useful to set the request concurrency `1` in full-stack
-      integration tests (e.g. Selenium) to prevent race conditions.
+      You might find it useful to set the request concurrency `1` in end-to-end tests
+      to prevent race conditions.
       Note that your browser might [impose its own request limit](http://www.browserscope.org/?category=network)
       regardless of what you configure here.
@@ -17220,7 +17396,7 @@ You can define custom animations using `up.transition()` and
     @stable
      */
-    var abortRequests, cache, config, handleCaching, isBusy, isIdle, isSafeMethod, makeRequest, mimicLocalRequest, parseRequestOptions, preload, queue, queueRequest, registerAliasForRedirect, reset, shouldReduceRequests, useCachedRequest;
+    var abortRequests, cache, config, handleCaching, isBusy, isIdle, isSafeMethod, makeRequest, mimicLocalRequest, parseRequestOptions, queue, queueRequest, registerAliasForRedirect, reset, shouldReduceRequests, useCachedRequest;
     config = new up.Config(function() {
       return {
         concurrency: 4,
@@ -17278,13 +17454,24 @@ You can define custom animations using `up.transition()` and
     /***
     Removes all [cache](/up.cache.get) entries.
-    Unpoly also automatically clears the cache whenever it processes
-    a request with an [unsafe](https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9.1.1)
-    HTTP method like `POST`.
+    To only remove some cache entries, pass a [URL pattern](/url-patterns):
+    ```js
+    up.cache.clear('/users/*')
+    ```
+    \#\#\# Other reasons the cache may clear
+    By default Unpoly automatically clears the entire cache whenever it processes
+    a request with an non-GET HTTP method. To customize this rule, use `up.network.config.clearCache`.
     The server may also clear the cache by sending an [`X-Up-Cache: clear`](/X-Up-Cache) header.
     @function up.cache.clear
+    @param {string} [pattern]
+      A [URL pattern](/url-patterns) matching cache entries that should be cleared.
+      If omitted, the entire cache is cleared.
     @stable
      */
@@ -17342,39 +17529,45 @@ You can define custom animations using `up.transition()` and
     Makes an AJAX request to the given URL.
     Returns an `up.Request` object which contains information about the request.
-    The request object is also a promise for its `up.Response`.
+    This request object is also a promise for an `up.Response` that contains
+    the response text, headers, etc.
     \#\#\# Example
-        let request = up.request('/search', { params: { query: 'sunshine' } })
-        console.log('We made a request to', request.url)
+    ```js
+    let request = up.request('/search', { params: { query: 'sunshine' } })
+    console.log('We made a request to', request.url)
-        let response = await request
-        console.log('The response text is', response.text)
+    let response = await request
+    console.log('The response text is', response.text)
+    ```
     \#\#\# Error handling
     The returned promise will fulfill with an `up.Response` when the server
     responds with an HTTP status of 2xx (like `200`).
-    When the server responds with an error code (like `422` or `500`), the promise
+    When the server responds with an HTTP error code (like `422` or `500`), the promise
     will *reject* with `up.Response`.
     When the request fails from a fatal error (like a timeout or loss of connectivity),
     the promise will reject with an [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) object.
-    Here is an example for a complete control flow that also handles errors:
+    Here is an example for a complete control flow that handles both HTTP error codes
+    and fatal errors:
-        try {
-          let response = await up.request('/search', { params: { query: 'sunshine' } })
-          console.log('Successful response with text:', response.text)
-        } catch (e) {
-          if (e instanceof up.Response) {
-            console.log('Server responded with HTTP status %s and text %s', e.status, e.text)
-          } else {
-            console.log('Fatal error during request:', e.message)
-          }
-        }
+    ```js
+    try {
+      let response = await up.request('/search', { params: { query: 'sunshine' } })
+      console.log('Successful response with text:', response.text)
+    } catch (e) {
+      if (e instanceof up.Response) {
+        console.log('Server responded with HTTP status %s and text %s', e.status, e.text)
+      } else {
+        console.log('Fatal error during request:', e.message)
+      }
+    }
+    ```
     \#\#\# Caching
@@ -17417,10 +17610,13 @@ You can define custom animations using `up.transition()` and
       With `{ cache: false }` (the default) Unpoly will always make a network request.
-    @param {boolean} [options.clearCache]
-      Whether to clear the cache after this request.
+    @param {boolean|string} [options.clearCache]
+      Whether to [clear](/up.cache.clear) the [cache](/up.cache.get) after this request.
-      Defaults to the result of `up.network.config.clearCache`.
+      You may also pass a [URL pattern](/url-patterns) to only clear matching requests.
+      Defaults to the result of `up.network.config.clearCache`, which
+      defaults to clearing the entire cache after a non-GET request.
     @param {Object} [options.headers={}]
       An object of additional HTTP headers.
@@ -17445,13 +17641,13 @@ You can define custom animations using `up.transition()` and
     @param {string} [options.target='body']
       The CSS selector that will be sent as an `X-Up-Target` header.
-    @param {string} [options.layer='current']
-      The [layer](/up.layer) this request is associated with.
     @param {string} [options.failTarget='body']
       The CSS selector that will be sent as an `X-Up-Fail-Target` header.
     @param {string} [options.layer='current']
+      The [layer](/up.layer) this request is associated with.
+    @param {string} [options.failLayer='current']
       The [layer](/up.layer) this request is associated with if the server [sends a HTTP status code](/server-errors).
     @param {Element} [options.origin]
@@ -17503,16 +17699,6 @@ You can define custom animations using `up.transition()` and
         return cache.clear(clearCache);
       }
     };
-    preload = function() {
-      var args, base, options;
-      args = 1 <= arguments.length ? slice.call(arguments, 0) : [];
-      if (typeof (base = up.migrate).handleNetworkPreloadArgs === "function") {
-        base.handleNetworkPreloadArgs.apply(base, args);
-      }
-      options = parseRequestOptions(args);
-      options.preload = true;
-      return makeRequest(options);
-    };
     parseRequestOptions = function(args) {
       var base, options;
       options = u.extractOptions(args);
@@ -17624,18 +17810,24 @@ You can define custom animations using `up.transition()` and
     Without arguments, this will abort all pending requests:
-        up.network.abort()
+    ```js
+    up.network.abort()
+    ```
     To abort a given `up.Request` object, pass it as the first argument:
-        let request = up.request('/path')
-        up.network.abort(request)
+    ```js
+    let request = up.request('/path')
+    up.network.abort(request)
+    ```
     To abort all requests matching a condition, pass a function that takes a request
     and returns a boolean value. Unpoly will abort all request for which the given
     function returns `true`. E.g. to abort all requests with a HTTP method as `GET`:
-        up.network.abort((request) => request.method == 'GET')
+    ```js
+    up.network.abort((request) => request.method == 'GET')
+    ```
     @function up.network.abort
     @param {up.Request|boolean|Function(up.Request): boolean} [matcher=true]
@@ -17797,7 +17989,6 @@ You can define custom animations using `up.transition()` and
     up.on('up:framework:reset', reset);
     return {
       request: makeRequest,
-      preload: preload,
       cache: cache,
       isIdle: isIdle,
       isBusy: isBusy,
@@ -17891,7 +18082,7 @@ You can define custom animations using `up.transition()` and
     up.layer.config.modal.openAnimation = 'move-from-top'
     ```
-    To configure an additional [main target](/main)
+    To configure an additional [main target](/up-main)
     for overlay of any mode:
     ```js
@@ -18198,7 +18389,7 @@ You can define custom animations using `up.transition()` and
       If set to `true` the overlay location and title will be shown in browser UI.
       If set to `'auto'` history will be visible if the initial overlay
-      content matches a [main target](/main).
+      content matches a [main target](/up-main).
     @param {string|Function} [options.animation]
       The opening animation.
@@ -18333,11 +18524,25 @@ You can define custom animations using `up.transition()` and
      */
     /***
-    TODO: Docs
+    This event is emitted after a new overlay has been placed into the DOM.
+    The event is emitted right before the opening animation starts. Because the overlay
+    has not been rendered by the browser, this makes it a good occasion to
+    [customize overlay elements](/customizing-overlays#customizing-overlay-elements):
+    ```js
+    up.on('up:layer:opened', function(event) {
+      if (isChristmas()) {
+        up.element.affix(event.layer.element, '.santa-hat', text: 'Merry Christmas!')
+      }
+    })
+    ```
     @event up:layer:opened
     @param {Element} event.origin
+      The link element that is opening the overlay.
     @param {up.Layer} event.layer
+      The [layer object](/up.Layer) that is opening.
     @stable
      */
@@ -18345,7 +18550,7 @@ You can define custom animations using `up.transition()` and
     This event is emitted after a layer's [location property](/up.Layer.prototype.location)
     has changed value.
-    This event is also emitted when a layer [without history](/up.Layer.prototype.historyVisible)
+    This event is also emitted when a layer [without visible history](/up.Layer.prototype.historyVisible)
     has reached a new location.
     @param {string} event.location
@@ -18381,6 +18586,7 @@ You can define custom animations using `up.transition()` and
       A promise that will settle when the overlay closes.
       When the overlay was accepted, the promise will fulfill with the overlay's acceptance value.
       When the overlay was dismissed, the promise will reject with the overlay's dismissal value.
     @stable
@@ -18412,7 +18618,7 @@ You can define custom animations using `up.transition()` and
     };
     /***
-    [Follows](/a-up-follow) this link and opens the result in a new layer.
+    [Follows](/a-up-follow) this link and opens the result in a new overlay.
     \#\#\# Example
@@ -18453,7 +18659,7 @@ You can define custom animations using `up.transition()` and
       If set to `true` the overlay location and title will be shown in browser UI.
       If set to `'auto'` history will be visible if the initial overlay
-      content matches a [main target](/main).
+      content matches a [main target](/up-main).
     @param [up-dismissable]
       How the overlay may be [dismissed](/closing-overlays) by the user.
@@ -18656,12 +18862,33 @@ You can define custom animations using `up.transition()` and
     The *current* layer is usually the [frontmost layer](/up.layer.front).
     There are however some cases where the current layer is a layer in the background:
-    - While an element in a background layer is [compiled](/up.compiler).
+    - While an element in a background layer is being [compiled](/up.compiler).
     - While an Unpoly event like `up:request:loaded` is being triggered from a background layer.
-    - While a running event listener was bound to a background layer using `up.Layer#on()`.
+    - While an event listener bound to a background layer using `up.Layer#on()` is being called.
     To temporarily change the current layer from your own code, use `up.Layer#asCurrent()`.
+    \#\#\# Remembering the current layer
+    Most functions in the `up.layer` package affect the current layer. E.g. `up.layer.dismiss()`
+    is shorthand for `up.layer.current.dismiss()`.
+    As described above `up.layer.current` is set to the right layer in compilers and most events,
+    even if that layer is not the frontmost layer.
+    If you have async code, the current layer may change when your callback is called.
+    To address this you may retrieve the current layer for later reference:
+    ```js
+    function dismissCurrentLayerIn(seconds) {
+      let savedLayer = up.layer.current // returns an up.Layer object
+      let dismiss = () => savedLayer.dismiss()
+      setTimeout(dismiss, seconds * 1000)
+    }
+    dismissCurrentLayerIn(10) //
+    ```
     @property up.layer.current
     @param {up.Layer} current
     @stable
@@ -18705,6 +18932,9 @@ You can define custom animations using `up.transition()` and
     /***
     Returns the [root layer](/layer-terminology).
+    The root layer represents the initial page before any overlay was [opened](/opening-overlays).
+    The root layer always exists and cannot be closed.
     @property up.layer.root
     @param {up.Layer} root
     @stable
@@ -18715,6 +18945,9 @@ You can define custom animations using `up.transition()` and
     If no overlay is open, an empty array is returned.
+    To get an array of *all* layers including the [root layer](/up.layer.root),
+    use `up.layer.stack`.
     @property up.layer.overlays
     @param {Array<up.Layer>} overlays
     @stable
@@ -18753,13 +18986,13 @@ You can define custom animations using `up.transition()` and
     /***
     [Accepts](/closing-overlays) the [current layer](up.layer.current).
-    This is a shortcut for `up.layer.current.dismiss()`.
-    See `up.Layer#dismiss()` for more documentation.
+    This is a shortcut for `up.layer.current.accept()`.
+    See `up.Layer#accept()` for more documentation.
-    @function up.layer.dismiss
+    @function up.layer.accept
     @param {any} [value]
     @param {Object} [options]
-    @return
+    @stable
      */
     /***
@@ -18771,7 +19004,7 @@ You can define custom animations using `up.transition()` and
     @function up.layer.dismiss
     @param {any} [value]
     @param {Object} [options]
-    @return
+    @stable
      */
     /***
@@ -18780,7 +19013,7 @@ You can define custom animations using `up.transition()` and
     This is a shortcut for `up.layer.current.isRoot()`.
     See `up.Layer#isRoot()` for more documentation..
-    @function up.layer.isFront
+    @function up.layer.isRoot
     @return {boolean}
     @stable
      */
@@ -18817,7 +19050,7 @@ You can define custom animations using `up.transition()` and
     @function up.layer.on
     @param {string} types
       A space-separated list of event types to bind to.
-    @param {string} [selector]
+    @param {string|Function(): string} [selector]
       The selector of an element on which the event must be triggered.
     @param {Object} [options]
     @param {Function(event, [element], [data])} listener
@@ -18834,9 +19067,8 @@ You can define custom animations using `up.transition()` and
     See `up.Layer#off()` for more documentation.
     @function up.layer.off
-    @param {Element|jQuery} [element=document]
     @param {string} events
-    @param {string} [selector]
+    @param {string|Function(): string} [selector]
     @param {Function(event, [element], [data])} listener
       The listener function to unbind.
     @stable
@@ -18849,7 +19081,6 @@ You can define custom animations using `up.transition()` and
     See `up.Layer#emit()` for more documentation.
     @function up.layer.emit
-    @param {Element|jQuery} [target=up.layer.element]
     @param {string} eventType
     @param {Object} [props={}]
     @stable
@@ -18879,7 +19110,7 @@ You can define custom animations using `up.transition()` and
      */
     /***
-    The location of the [current layer](/up.layer.current).
+    The location URL of the [current layer](/up.layer.current).
     This is a shortcut for `up.layer.current.location`.
     See `up.Layer#location` for more documentation.
@@ -18890,9 +19121,8 @@ You can define custom animations using `up.transition()` and
      */
     /***
-    The [current layer](/up.layer.current)'s mode which governs its appearance and behavior.
-    @see layer-terminology
+    The [current layer](/up.layer.current)'s [mode](/up.layer.mode)
+    which governs its appearance and behavior.
     @property up.layer.mode
     @param {string} mode
@@ -19001,7 +19231,7 @@ new page is loading.
   var slice = [].slice;
   up.link = (function() {
-    var ATTRIBUTES_SUGGESTING_FOLLOW, LINKS_WITH_LOCAL_HTML, LINKS_WITH_REMOTE_HTML, combineFollowableSelectors, config, convertClicks, didUserDragAway, e, follow, followMethod, followOptions, followURL, forkEventAsUpClick, fullClickableSelector, fullFollowSelector, fullInstantSelector, fullPreloadSelector, isFollowDisabled, isFollowable, isInstant, isInstantDisabled, isPreloadDisabled, isSafe, lastMousedownTarget, linkPreloader, makeClickable, makeFollowable, parseRequestOptions, preload, reset, shouldFollowEvent, shouldPreload, targetMacro, u, willCache;
+    var ATTRIBUTES_SUGGESTING_FOLLOW, LINKS_WITH_LOCAL_HTML, LINKS_WITH_REMOTE_HTML, combineFollowableSelectors, config, convertClicks, didUserDragAway, e, follow, followMethod, followOptions, followURL, forkEventAsUpClick, fullClickableSelector, fullFollowSelector, fullInstantSelector, fullPreloadSelector, isFollowDisabled, isFollowable, isInstant, isInstantDisabled, isPreloadDisabled, isSafe, lastMousedownTarget, linkPreloader, makeClickable, makeFollowable, parseRequestOptions, preload, reset, shouldFollowEvent, shouldPreload, u, willCache;
     u = up.util;
     e = up.element;
     linkPreloader = new up.LinkPreloader();
@@ -19018,9 +19248,10 @@ new page is loading.
     };
     /***
-    TODO: Docs
-    TODO: Doucment that noInstantSelectors and noPreloadSelectors inherit from noFollowSelectors
-    TODO: Document that noFollowSelectors already excludes cross-origin, rel=download, [target], [href^=#], javascript: hrefs
+    Configures defaults for link handling.
+    In particular you can configure Unpoly to handle [all links on the page](/handling-everything)
+    without requiring developers to set `[up-...]` attributes.
     @property up.link.config
@@ -19093,7 +19324,7 @@ new page is loading.
       If set to `false`, Unpoly will never preload links.
-    @param {Array<string>} [config.cickableSelectors]
+    @param {Array<string>} [config.clickableSelectors]
       A list of CSS selectors matching elements that should behave like links or buttons.
       @see [up-clickable]
@@ -19167,7 +19398,7 @@ new page is loading.
     /***
     Follows the given link with JavaScript and updates a fragment with the server response.
-    By default the layer's [main element](/main)
+    By default the layer's [main element](/up-main)
     will be replaced. Attributes like `a[up-target]`
     or `a[up-layer]` will be honored.
@@ -19229,8 +19460,24 @@ new page is loading.
     };
     /***
-    Parses the `render()` options that would be used to
-    [`follow`](/up.follow) the given link, but does not [render](/up.render).
+    Parses the [render](/up.render) options that would be used to
+    [`follow`](/up.follow) the given link, but does not render.
+    \#\#\# Example
+    Given a link with some `[up-...]` attributes:
+    ```html
+    <a href="/foo" up-target=".content" up-layer="new">...</a>
+    ```
+    We can parse the link's render options like this:
+    ```js
+    let link = document.querySelector('a[href="/foo"]')
+    let options = up.link.followOptions(link)
+    // => { url: '/foo', method: 'GET', target: '.content', layer: 'new', ... }
+    ```
     @function up.link.followOptions
     @param {Element|jQuery|string} link
@@ -19348,7 +19595,10 @@ new page is loading.
     @param {Object} options
       See options for `up.follow()`.
     @return {Promise}
-      A promise that will be fulfilled when the request was loaded and cached
+      A promise that will be fulfilled when the request was loaded and cached.
+      When preloading is [disabled](/up.link.config#config.preloadEnabled) the promise
+      rejects with an `AbortError`.
     @stable
      */
     preload = function(link, options) {
@@ -19452,7 +19702,7 @@ new page is loading.
     @function up.link.makeFollowable
     @param {Element|jQuery|string} link
       The element or selector for the link to make followable.
-    @stable
+    @experimental
      */
     makeFollowable = function(link) {
       if (!isFollowable(link)) {
@@ -19588,6 +19838,13 @@ new page is loading.
     If the user activates an element using their keyboard, the `up:click` event will be emitted
     when the key is pressed even if the element has an `[up-instant]` attribute.
+    \#\#\# Only unmodified clicks are considered
+    To prevent overriding native browser behavior, the `up:click` is only emitted for unmodified clicks.
+    In particular, it is not emitted when the user holds `Shift`, `CTRL` or `Meta` while clicking.
+    Neither it is emitted when the user clicks with a secondary mouse button.
     @event up:click
     @param {Element} event.target
       The clicked element.
@@ -19610,20 +19867,6 @@ new page is loading.
       method = followMethod(link);
       return up.network.isSafeMethod(method);
     };
-    targetMacro = function(queryAttr, fixedResultAttrs, callback) {
-      return up.macro("[" + queryAttr + "]", function(link) {
-        var optionalTarget, resultAttrs;
-        resultAttrs = u.copy(fixedResultAttrs);
-        if (optionalTarget = link.getAttribute(queryAttr)) {
-          resultAttrs['up-target'] = optionalTarget;
-        } else {
-          resultAttrs['up-follow'] = '';
-        }
-        e.setMissingAttrs(link, resultAttrs);
-        link.removeAttribute(queryAttr);
-        return typeof callback === "function" ? callback() : void 0;
-      });
-    };
     /***
     [Follows](/up.follow) this link with JavaScript and updates a fragment with the server response.
@@ -19639,7 +19882,7 @@ new page is loading.
     <a href="/posts/5" up-follow up-target=".content">Read post</a>
     ```
-    If no `[up-target]` attribute is set, the [main target](/main) is updated.
+    If no `[up-target]` attribute is set, the [main target](/up-main) is updated.
     \#\#\# Advanced fragment changes
@@ -19676,14 +19919,14 @@ new page is loading.
     @param [up-target]
       The CSS selector to update.
-      If omitted a [main target](/main) will be rendered.
+      If omitted a [main target](/up-main) will be rendered.
     @param [up-fallback]
       Specifies behavior if the [target selector](/up.render#options.target) is missing from the current page or the server response.
       If set to a CSS selector, Unpoly will attempt to replace that selector instead.
-      If set to `true` Unpoly will attempt to replace a [main target](/main) instead.
+      If set to `true` Unpoly will attempt to replace a [main target](/up-main) instead.
       If set to `false` Unpoly will immediately reject the render promise.
@@ -19757,7 +20000,7 @@ new page is loading.
       If set to `auto` history will be updated if the `[up-target]` matches
       a selector in `up.fragment.config.autoHistoryTargets`. By default this contains all
-      [main targets](/main).
+      [main targets](/up-main).
       If set to `false`, the history will remain unchanged.
@@ -19917,37 +20160,6 @@ new page is loading.
     @stable
      */
-    /***
-    [Follows](/up.follow) this link as fast as possible.
-    This is done by:
-    - [Following the link through AJAX](/a-up-follow) instead of a full page load
-    - [Preloading the link's destination URL](/a-up-preload)
-    - [Triggering the link on `mousedown`](/a-up-instant) instead of on `click`
-    \#\#\# Example
-    Use `[up-dash]` like this:
-        <a href="/users" up-dash=".main">User list</a>
-    This is shorthand for:
-        <a href="/users" up-target=".main" up-instant up-preload>User list</a>
-    @selector a[up-dash]
-    @param [up-dash='body']
-      The CSS selector to replace
-      Inside the CSS selector you may refer to this link as `&` ([like in Sass](https://sass-lang.com/documentation/file.SASS_REFERENCE.html#parent-selector)).
-    @stable
-     */
-    targetMacro('up-dash', {
-      'up-preload': '',
-      'up-instant': ''
-    });
     /***
     Add an `[up-expand]` attribute to any element to enlarge the click area of a
     descendant link.
@@ -20036,7 +20248,6 @@ new page is loading.
       isFollowable: isFollowable,
       shouldFollowEvent: shouldFollowEvent,
       followMethod: followMethod,
-      targetMacro: targetMacro,
       convertClicks: convertClicks,
       config: config,
       combineFollowableSelectors: combineFollowableSelectors
@@ -20065,7 +20276,7 @@ The `up.form` module helps you work with non-trivial forms.
   var slice = [].slice;
   up.form = (function() {
-    var ATTRIBUTES_SUGGESTING_SUBMIT, abortScheduledValidate, autosubmit, config, e, fieldSelector, findFields, findSwitcherForTarget, findValidateTarget, findValidateTargetFromConfig, focusedField, fullSubmitSelector, getContainer, isSubmitDisabled, observe, observeCallbackFromElement, reset, submit, submitButtonSelector, submitOptions, submittingButton, switchTarget, switchTargets, switcherValues, u, validate;
+    var ATTRIBUTES_SUGGESTING_SUBMIT, abortScheduledValidate, autosubmit, config, e, fieldSelector, findFields, findSwitcherForTarget, findValidateTarget, findValidateTargetFromConfig, focusedField, fullSubmitSelector, getContainer, isSubmitDisabled, isSubmittable, observe, observeCallbackFromElement, reset, submit, submitButtonSelector, submitOptions, submittingButton, switchTarget, switchTargets, switcherValues, u, validate;
     u = up.util;
     e = up.element;
     ATTRIBUTES_SUGGESTING_SUBMIT = ['[up-submit]', '[up-target]', '[up-layer]', '[up-transition]'];
@@ -20242,8 +20453,26 @@ The `up.form` module helps you work with non-trivial forms.
     });
     /***
-    Parses the `render()` options that would be used to
-    [`submit`](/up.submit) the given form, but does not [render](/up.render).
+    Parses the [render](/up.render) options that would be used to
+    [`submit`](/up.submit) the given form, but does not render.
+    \#\#\# Example
+    Given a form element:
+    ```html
+    <form action="/foo" method="post" up-target=".content">
+      ...
+    </form>
+    ```
+    We can parse the link's render options like this:
+    ```js
+    let form = document.querySelector('form')
+    let options = up.form.submitOptions(form)
+    // => { url: '/foo', method: 'POST', target: '.content', ... }
+    ```
     @param {Element|jQuery|string} form
       The form to submit.
@@ -20296,7 +20525,23 @@ The `up.form` module helps you work with non-trivial forms.
     /***
     This event is [emitted](/up.emit) when a form is [submitted](/up.submit) through Unpoly.
-    The event is emitted on the`<form>` element.
+    The event is emitted on the `<form>` element.
+    When the form is being [validated](/input-up-validate), this event is not emitted.
+    Instead an `up:form:validate` event is emitted.
+    \#\#\# Changing render options
+    Listeners may inspect and manipulate [render options](/up.render) for the coming fragment update.
+    The code below will use a custom [transition](/up-transition)
+    when a form submission [fails](/server-errors):
+    ```js
+    up.on('up:form:submit', function(event, form) {
+      event.renderOptions.failTransition = 'shake'
+    })
+    ```
     @event up:form:submit
     @param {Element} event.target
@@ -20310,7 +20555,11 @@ The `up.form` module helps you work with non-trivial forms.
     @stable
      */
     up.on('up:click', submitButtonSelector, function(event, button) {
-      return button.focus();
+      var form;
+      form = e.closest(button, 'form');
+      if (form && isSubmittable(form)) {
+        return button.focus();
+      }
     });
     /***
@@ -20395,10 +20644,10 @@ The `up.form` module helps you work with non-trivial forms.
     /***
     [Observes](/up.observe) a field or form and submits the form when a value changes.
-    Both the form and the changed field will be assigned a CSS class [`form-up-active`](/form-up-active)
+    Both the form and the changed field will be assigned a CSS class [`.up-active`](/form-up-active)
     while the autosubmitted form is processing.
-    The unobtrusive variant of this is the [`up-autosubmit`](/form-up-autosubmit) attribute.
+    The unobtrusive variant of this is the [`[up-autosubmit]`](/form-up-autosubmit) attribute.
     @function up.autosubmit
     @param {string|Element|jQuery} target
@@ -20452,7 +20701,9 @@ The `up.form` module helps you work with non-trivial forms.
     \#\#\# Example
-        up.validate('input[name=email]', { target: '.email-errors' })
+    ```js
+    up.validate('input[name=email]', { target: '.email-errors' })
+    ```
     @function up.validate
     @param {string|Element|jQuery} field
@@ -20496,6 +20747,7 @@ The `up.form` module helps you work with non-trivial forms.
     @param event.preventDefault()
       Event listeners may call this method to prevent the validation request
       being sent to the server.
+    @stable
      */
     switcherValues = function(field) {
       var checkedButton, form, groupName, meta, value, values;
@@ -20608,6 +20860,30 @@ The `up.form` module helps you work with non-trivial forms.
         return element;
       }
     };
+    /***
+    Returns whether the given form will be [submitted](/up.follow) through Unpoly
+    instead of making a full page load.
+    By default Unpoly will follow forms if the element has
+    one of the following attributes:
+    - `[up-submit]`
+    - `[up-target]`
+    - `[up-layer]`
+    - `[up-transition]`
+    To consider other selectors to be submittable, see `up.form.config.submitSelectors`.
+    @function up.form.isSubmittable
+    @param {Element|jQuery|string} form
+      The form to check.
+    @stable
+     */
+    isSubmittable = function(form) {
+      form = up.fragment.get(form);
+      return e.matches(form, fullSubmitSelector()) && !isSubmitDisabled(form);
+    };
     isSubmitDisabled = function(form) {
       return e.matches(form, config.noSubmitSelectors.join(','));
     };
@@ -20628,7 +20904,7 @@ The `up.form` module helps you work with non-trivial forms.
     </form>
     ```
-    \#\#\# Failed submission
+    \#\#\# Handling validation errors
     When the server was unable to save the form due to invalid params,
     it will usually re-render an updated copy of the form with
@@ -20643,19 +20919,35 @@ The `up.form` module helps you work with non-trivial forms.
     [`:status` option to `render`](http://guides.rubyonrails.org/layouts_and_rendering.html#the-status-option)
     for this:
-        class UsersController < ApplicationController
-          def create
-            user_params = params[:user].permit(:email, :password)
-            @user = User.new(user_params)
-            if @user.save?
-              sign_in @user
-            else
-              render 'form', status: :bad_request
-            end
-          end
+    ```ruby
+    class UsersController < ApplicationController
+      def create
+        user_params = params[:user].permit(:email, :password)
+        @user = User.new(user_params)
+        if @user.save?
+          sign_in @user
+        else
+          render 'form', status: :bad_request
         end
+      end
+    end
+    ```
+    You may define different option for the failure case by infixing an attribute with `fail`:
+    ```html
+    <form method="post" action="/action"
+      up-target=".content"
+      up-fail-target="form"
+      up-scroll="auto"
+      up-fail-scroll=".errors">
+      ...
+    </form>
+    ```
+    See [handling server errors](/server-errors) for details.
     Note that you can also use
     [`input[up-validate]`](/input-up-validate) to perform server-side
@@ -20663,7 +20955,7 @@ The `up.form` module helps you work with non-trivial forms.
     \#\#\# Giving feedback while the form is processing
-    The `<form>` element will be assigned a CSS class [`up-active`](/form.up-active) while
+    The `<form>` element will be assigned a CSS class [`.up-active`](/form.up-active) while
     the submission is loading.
     \#\#\# Short notation
@@ -21073,7 +21365,7 @@ The `up.form` module helps you work with non-trivial forms.
     /***
     Submits this field's form when this field changes its values.
-    Both the form and the changed field will be assigned a CSS class [`up-active`](/form-up-active)
+    Both the form and the changed field will be assigned a CSS class [`.up-active`](/form-up-active)
     while the autosubmitted form is loading.
     The programmatic variant of this is the [`up.autosubmit()`](/up.autosubmit) function.
@@ -21102,7 +21394,7 @@ The `up.form` module helps you work with non-trivial forms.
         </div>
     @selector input[up-autosubmit]
-    @param up-delay
+    @param [up-delay]
       The number of miliseconds to wait after a change before the form is submitted.
     @stable
      */
@@ -21110,7 +21402,7 @@ The `up.form` module helps you work with non-trivial forms.
     /***
     Submits the form when any field changes.
-    Both the form and the field will be assigned a CSS class [`up-active`](/form-up-active)
+    Both the form and the field will be assigned a CSS class [`.up-active`](/form-up-active)
     while the autosubmitted form is loading.
     The programmatic variant of this is the [`up.autosubmit()`](/up.autosubmit) function.
@@ -21125,7 +21417,7 @@ The `up.form` module helps you work with non-trivial forms.
         </form>
     @selector form[up-autosubmit]
-    @param up-delay
+    @param [up-delay]
       The number of miliseconds to wait after a change before the form is submitted.
     @stable
      */
@@ -21137,6 +21429,7 @@ The `up.form` module helps you work with non-trivial forms.
       config: config,
       submit: submit,
       submitOptions: submitOptions,
+      isSubmittable: isSubmittable,
       observe: observe,
       validate: validate,
       autosubmit: autosubmit,
@@ -21162,43 +21455,53 @@ Navigation feedback
 ===================
 The `up.feedback` module adds useful CSS classes to links while they are loading,
-or when they point to the current URL. By styling these classes you may
-provide instant feedback to user interactions. This improves the perceived speed of your interface.
+or when they point to the current URL.
+By styling these classes you may provide instant feedback to user interactions,
+improving the perceived speed of your interface.
 \#\#\# Example
 Let's say we have an `<nav>` element with two links, pointing to `/foo` and `/bar` respectively:
-    <nav>
-      <a href="/foo" up-follow>Foo</a>
-      <a href="/bar" up-follow>Bar</a>
-    </nav>
+```html
+<nav>
+  <a href="/foo" up-follow>Foo</a>
+  <a href="/bar" up-follow>Bar</a>
+</nav>
+```
 By giving the navigation bar the `[up-nav]` attribute, links pointing to the current browser address are highlighted
 as we navigate through the site.
 If the current URL is `/foo`, the first link is automatically marked with an [`.up-current`](/a.up-current) class:
-    <nav up-nav>
-      <a href="/foo" up-follow class="up-current">Foo</a>
-      <a href="/bar" up-follow>Bar</a>
-    </nav>
+```html
+<nav up-nav>
+  <a href="/foo" up-follow class="up-current">Foo</a>
+  <a href="/bar" up-follow>Bar</a>
+</nav>
+```
 When the user clicks on the `/bar` link, the link will receive the [`up-active`](/a.up-active) class while it is waiting
 for the server to respond:
-    <nav up-nav>
-      <a href="/foo" up-follow class="up-current">Foo</a>
-      <a href="/bar" up-follow class="up-active">Bar</a>
-    </div>
+```
+<nav up-nav>
+  <a href="/foo" up-follow class="up-current">Foo</a>
+  <a href="/bar" up-follow class="up-active">Bar</a>
+</div>
+```
 Once the response is received the URL will change to `/bar` and the `up-active` class is removed:
-    <nav up-nav>
-      <a href="/foo" up-follow>Foo</a>
-      <a href="/bar" up-follow class="up-current">Bar</a>
-    </nav>
+```html
+<nav up-nav>
+  <a href="/foo" up-follow>Foo</a>
+  <a href="/bar" up-follow class="up-current">Bar</a>
+</nav>
+```
 @see [up-nav]
 @see a.up-current
@@ -21504,7 +21807,7 @@ Once the response is received the URL will change to `/bar` and the `up-active`
      */
     /***
-    Links within `[up-nav]` may use the `[up-alias]` attribute to pass an [URL pattern](/url-patterns) for which they
+    Links within `[up-nav]` may use the `[up-alias]` attribute to pass a [URL pattern](/url-patterns) for which they
     should also be highlighted as [`.up-current`](a.up-current).
     \#\#\# Example
@@ -21517,7 +21820,7 @@ Once the response is received the URL will change to `/bar` and the `up-active`
     </div>
     ```
-    To pass more than one alternative URLs, use an [URL pattern](/url-patterns).
+    To pass more than one alternative URLs, use a [URL pattern](/url-patterns).
     @selector a[up-alias]
     @param up-alias