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

unpoly-rails 2.0.0.pre.rc7 → 2.0.0

Potentially problematic release.

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

Files changed (10) hide show

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee83873d9c7f873fadc60c7492768b88d15a74a6a835283b1c7ab80c2de08ab0
-  data.tar.gz: b1fdcc27628534630d100b5f5b728147b9155865b141a02dd3944c6857e9e1dc
+  metadata.gz: 60a37ba382e3664b7224d805da146e4a7364e7880dbcdb80580a0e9ef4406672
+  data.tar.gz: 8d899df9850761c7b07849b2ded8a241e334c9e4cbc3ac8dc5003af0629206ad
 SHA512:
-  metadata.gz: e930f20386dbb9ac7cf8eb0171850f9a2a27bc46274b2b351d558f0cb8f054ba05beb3ca325b3d09de6c441d828f862c4fb84ec8bc17196607cf5ab453b78a74
-  data.tar.gz: f736ba5790176658ae0eef6d6fdd3228c9808f9ae3368dd08ea81ddbe1bbee5fa84e8d2818fe78d209f12d315effe7f2612054c0872f810f9cf195b73ef1af0d
+  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/README.md CHANGED Viewed

@@ -1,4 +1,4 @@
-[Unpoly](https://unpoly.com)
+[Unpoly 2](https://unpoly.com)
 ======
 Unobtrusive JavaScript framework for server-side applications
@@ -6,7 +6,9 @@ Unobtrusive JavaScript framework for server-side applications
 [Unpoly](https://unpoly.com) enables fast and flexible frontends with minimal changes to your server-side code.
-This repository is home to both the Unpoly JavaScript code and its (optional) bindings for Ruby on Rails (`unpoly-rails` gem).
+This repository is home to both the Unpoly 2 JavaScript code and its (optional) bindings for Ruby on Rails (`unpoly-rails` gem).
+If you're looking for the code of Unpoly 0.x or 1.0, use the [`1.x-stable`](https://github.com/unpoly/unpoly/tree/1.x-stable) branch.
 Getting started
@@ -33,6 +35,7 @@ Install dependencies for tests:
 - Install Ruby 2.3.8
 - Install Bundler by running `gem install bundler`
+- Install Node.js (required for building the library)
 - `cd` into `spec_app`
 - Install dependencies by running `bundle install`
@@ -50,11 +53,9 @@ To run RSpec tests for the `unpoly-rails` gem:
 ### Making a new release
-We are currently feeding four release channels:
+We are currently feeding two release channels:
-- Manual download from GitHub
 - npm
-- Bower (which is based on Git and version tags)
 - Rubygems (as the `unpoly-rails` gem)
 We always release to all channel simultaneously.

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,16 +922,21 @@ 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"]');
   });
 }).call(this);
+/***
+@module up.layer
+ */
 (function() {
   var e, u;
@@ -1060,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');
   };
@@ -1081,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]
@@ -1124,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

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,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(){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 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-rc7"
+    version: "2.0.0"
   };
 }).call(this);
@@ -110,20 +110,21 @@ to not include another library in your asset bundle.
     };
     /***
-    Normalizes relative paths and absolute paths to a full URL
-    that can be checked for equality with other normalized URLs.
-    By default hashes are ignored, search queries are included.
+    Normalizes the given URL or path.
     @function up.util.normalizeURL
     @param {boolean} [options.host='cross-domain']
       Whether to include protocol, hostname and port in the normalized URL.
+      By default the host is only included if it differ's from the page's hostname.
     @param {boolean} [options.hash=false]
       Whether to include an `#hash` anchor in the normalized URL
     @param {boolean} [options.search=true]
       Whether to include a `?query` string in the normalized URL
     @param {boolean} [options.stripTrailingSlash=false]
       Whether to strip a trailing slash from the pathname
+    @return {string}
+      The normalized URL.
     @internal
      */
     normalizeURL = function(urlOrAnchor, options) {
@@ -178,6 +179,15 @@ to not include another library in your asset bundle.
     If the given URL is not fully qualified, it is assumed to be relative
     to the current page.
+    \#\#\# Example
+    ```js
+    let parsed = up.util.parseURL('/path?foo=value')
+    parsed.pathname // => '/path'
+    parsed.search // => '/?foo=value'
+    parsed.hash // => ''
+    ```
     @function up.util.parseURL
     @return {Object}
       The parsed URL as an object with
@@ -732,7 +742,7 @@ to not include another library in your asset bundle.
     @function up.util.isList
     @param value
     @return {boolean}
-    @experimental
+    @stable
      */
     isList = function(value) {
       return isArray(value) || isNodeList(value) || isArguments(value) || isJQuery(value) || isHTMLCollection(value);
@@ -775,9 +785,20 @@ to not include another library in your asset bundle.
     };
     /***
+    Returns the given value if it is [array-like](/up.util.isList), otherwise
+    returns an array with the given value as its only element.
+    \#\#\# Example
+    ```js
+    up.util.wrapList([1, 2, 3]) // => [1, 2, 3]
+    up.util.wrapList('foo') // => ['foo']
+    ```
     @function up.util.wrapList
+    @param {any} value
     @return {Array|NodeList|jQuery}
-    @internal
+    @experimental
      */
     wrapList = function(value) {
       if (isList(value)) {
@@ -1238,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];
@@ -1281,6 +1303,7 @@ to not include another library in your asset bundle.
     @function up.util.pick
     @param {Object} object
     @param {Array} keys
+    @return {Object}
     @stable
      */
     pick = function(object, keys) {
@@ -1294,6 +1317,20 @@ to not include another library in your asset bundle.
       }
       return filtered;
     };
+    /***
+    Returns a copy of the given object that only contains
+    properties that pass the given tester function.
+    @function up.util.pickBy
+    @param {Object} object
+    @param {Function<string, string, object>} tester
+      A function that will be called with each property.
+      The arguments are the property value, key and the entire object.
+    @return {Object}
+    @experimental
+     */
     pickBy = function(object, tester) {
       var filtered, key, value;
       tester = iteratee(tester);
@@ -1359,8 +1396,20 @@ to not include another library in your asset bundle.
     If the given `value` is a function, calls the function with the given `args`.
     Otherwise it just returns `value`.
+    \#\#\# Example
+    ```js
+    up.util.evalOption(5) // => 5
+    let fn = () => 1 + 2
+    up.util.evalOption(fn) // => 3
+    ```
     @function up.util.evalOption
-    @internal
+    @param {any} value
+    @param {Array} ...args
+    @return {any}
+    @experimental
      */
     evalOption = function() {
       var args, value;
@@ -1384,7 +1433,7 @@ to not include another library in your asset bundle.
     @function up.util.escapeHTML
     @param {string} string
-      The text that should be escaped
+      The text that should be escaped.
     @stable
      */
     escapeHTML = function(string) {
@@ -1400,6 +1449,17 @@ to not include another library in your asset bundle.
     escapeRegExp = function(string) {
       return string.replace(/[\\^$*+?.()|[\]{}]/g, '\\$&');
     };
+    /***
+    Deletes the property with the given key from the given object
+    and returns its value.
+    @function up.util.pluckKey
+    @param {Object} object
+    @param {string} key
+    @return {any}
+    @experimental
+     */
     pluckKey = function(object, key) {
       var value;
       value = object[key];
@@ -1431,7 +1491,6 @@ to not include another library in your asset bundle.
     @param {Array<Function()>} functions
     @return {Function()}
       A function that will call all `functions` if called.
     @internal
      */
     sequence = function(functions) {
@@ -1447,7 +1506,13 @@ to not include another library in your asset bundle.
     };
     /***
-    Flattens the given `array` a single level deep.
+    Flattens the given `array` a single depth level.
+    \#\#\# Example
+    ```js
+    let nested = [1, [2, 3], [4]]
+    up.util.flatten(nested) // => [1, 2, 3, 4]
     @function up.util.flatten
     @param {Array} array
@@ -1472,7 +1537,7 @@ to not include another library in your asset bundle.
     /***
     Maps each element using a mapping function,
-    then flattens the result into a new array.
+    then [flattens](/up.util.flatten) the result into a new array.
     @function up.util.flatMap
     @param {Array} array
@@ -1508,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;
@@ -2081,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
  */
@@ -2097,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
@@ -2107,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();
@@ -2239,7 +2308,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
   var slice = [].slice;
   up.element = (function() {
-    var CSS_LENGTH_PROPS, MATCH_FN_NAME, SINGLETON_PATTERN, SINGLETON_TAG_NAMES, affix, all, ancestor, around, attributeSelector, booleanAttr, booleanOrStringAttr, callbackAttr, closest, closestAttr, computedStyle, computedStyleNumber, concludeCSSTransition, createDocumentFromHTML, createFromHTML, createFromSelector, cssLength, elementTagName, extractFromStyleObject, first, fixedToAbsolute, getList, getOne, getRoot, hasCSSTransition, hide, idSelector, inlineStyle, insertBefore, isDetached, isInSubtree, isSingleton, isSingletonSelector, isVisible, jsonAttr, matches, metaContent, normalizeStyleValueForWrite, numberAttr, paint, remove, replace, setAttrs, setInlineStyle, setMissingAttr, setMissingAttrs, setTemporaryAttrs, setTemporaryStyle, show, stringAttr, subtree, toSelector, toggle, toggleAttr, toggleClass, trueAttributeSelector, u, unwrap, upAttrs, valueToList, wrapChildren;
+    var CSS_LENGTH_PROPS, MATCH_FN_NAME, SINGLETON_PATTERN, SINGLETON_TAG_NAMES, affix, all, ancestor, around, attributeSelector, booleanAttr, booleanOrStringAttr, callbackAttr, classSelector, closest, closestAttr, computedStyle, computedStyleNumber, concludeCSSTransition, createDocumentFromHTML, createFromHTML, createFromSelector, cssLength, elementTagName, extractFromStyleObject, first, fixedToAbsolute, getList, getOne, getRoot, hasCSSTransition, hide, idSelector, inlineStyle, insertBefore, isDetached, isInSubtree, isSingleton, isSingletonSelector, isVisible, jsonAttr, matches, metaContent, normalizeStyleValueForWrite, numberAttr, paint, remove, replace, setAttrs, setInlineStyle, setMissingAttr, setMissingAttrs, setTemporaryAttrs, setTemporaryStyle, show, stringAttr, subtree, toSelector, toggle, toggleAttr, toggleClass, trueAttributeSelector, u, unwrap, upAttrs, valueToList, wrapChildren;
     u = up.util;
     MATCH_FN_NAME = up.browser.isIE11() ? 'msMatchesSelector' : 'matches';
@@ -2521,6 +2590,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     [this WHATWG mailing list post](http://lists.w3.org/Archives/Public/public-whatwg-archive/2014Apr/0094.html).
     @function up.element.show
+    @param {Element} element
     @stable
      */
     show = function(element) {
@@ -2559,8 +2629,10 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     @param {Element} element
       The element for which to add or remove the class.
     @param {string} className
-      A boolean value to determine whether the class should be added or removed.
-    @param {string} state
+      The class which should be added or removed.
+    @param {Boolean} [newPresent]
+      Pass `true` to add the class to the element or `false` to remove it.
       If omitted, the class will be added if missing and removed if present.
     @stable
      */
@@ -2909,6 +2981,15 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
       }
     };
+    /***
+    @function up.element.classSelector
+    @internal
+     */
+    classSelector = function(klass) {
+      klass = klass.replace(/:/g, '\\:');
+      return "." + klass;
+    };
     /***
     Always creates a full document with a <html> root, even if the given `html`
     is only a fragment.
@@ -3442,6 +3523,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
       affix: affix,
       toSelector: toSelector,
       idSelector: idSelector,
+      classSelector: classSelector,
       isSingleton: isSingleton,
       isSingletonSelector: isSingletonSelector,
       attributeSelector: attributeSelector,
@@ -4986,7 +5068,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     };
     CompilerPass.prototype.runCompiler = function(compiler) {
-      var i, j, keepValue, len, len1, match, matches, results, value;
+      var base, i, len, match, matches;
       matches = this.select(compiler.selector);
       if (!matches.length) {
         return;
@@ -5002,15 +5084,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
           this.compileOneElement(compiler, match);
         }
       }
-      if (keepValue = compiler.keep) {
-        value = u.isString(keepValue) ? keepValue : '';
-        results = [];
-        for (j = 0, len1 = matches.length; j < len1; j++) {
-          match = matches[j];
-          results.push(match.setAttribute('up-keep', value));
-        }
-        return results;
-      }
+      return typeof (base = up.migrate).postCompile === "function" ? base.postCompile(matches, compiler) : void 0;
     };
     CompilerPass.prototype.compileOneElement = function(compiler, element) {
@@ -6231,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
    */
@@ -6259,66 +6337,46 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
-    This layer's mode which governs its appearance and behavior.
-    Available layer modes are:
+    Whether fragment updates within this layer can affect browser history and window title.
-    - `'root'`
-    - `'modal'`
-    - `'popup'`
-    - `'drawer'`
-    - `'cover'`
+    If a layer does not have visible history, its desendant layers cannot have history either.
-    @property up.Layer#mode
-    @param {string} mode
+    @property up.Layer#historyVisible
+    @param {boolean} historyVisible
     @stable
      */
     /***
-    Whether fragment updates within this layer can affect browser history and window title.
+    This layer's mode which governs its appearance and behavior.
-    @property up.Layer#historyVisible
-    @param {boolean} historyVisible
+    @see layer-terminology
+    @property up.Layer#mode
+    @param {string} mode
+    @stable
      */
     /***
-    This layer's context object.
-    Think of *context* as [session storage](/https://makandracards.com/makandra/32865), but specific to a [layer](/up.layer)
-    rather than specific to an entire browser tab.
-    You may access the context object's properties like a regular JavaScript object.
+    This layer's [context](/context).
     \#\#\# Example
+    You may access the context properties like a regular JavaScript object.
     ```js
     let layer = up.layer.current
     layer.context.message = 'Please select a contact'
     console.log(layer.context) // logs "{ message: 'Please select a contact' }"
     ```
-    \#\#\# Accessing the context from the server
-    The context is is sent as an `X-Up-Context` header along with every
-    [request](/up.request) to the server. The server may also update the updating
-    layer's context by including an `X-Up-Context` header in its response.
     @property up.Layer#context
     @param {Object} context
-    @stable
-     */
-    /***
-    Whether fragment updates within this layer will affect [browser history](/up.history).
-    If a layer does not have visible history, its desendant layers cannot have history either.
+      The context object.
-    @property up.Layer#historyVisible
-    @param {boolean} historyVisible
-    @stable
+      If no context has been set an empty object is returned.
+    @experimental
      */
     Layer.prototype.keys = function() {
@@ -6377,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]
@@ -6415,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.
@@ -6490,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
      */
@@ -6571,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
@@ -6587,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
@@ -6602,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
@@ -6661,7 +6727,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
-    Listens to a ([DOM event](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model/Events) that originated
+    Listens to a [DOM event](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model/Events) that originated
     on an element [contained](/up.Layer.prototype.contains) by this layer.
     This will ignore events emitted on elements in [descendant](/up.Layer.prototype.descendants) overlays,
@@ -6698,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
      */
@@ -6733,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
      */
@@ -6911,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.
@@ -7236,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) {
@@ -7375,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) {
@@ -8888,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) {
@@ -8906,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) {
@@ -9253,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
    */
@@ -9304,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
    */
@@ -9341,6 +9434,23 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
      */
+    /***
+    The [hash component](https://en.wikipedia.org/wiki/URI_fragment) of this request's URL.
+    The `{ hash }` property is automatically extracted from the given URL:
+    ```js
+    let request = up.request({ url: '/path#section' })
+    request.url // => '/path'
+    request.hash // => '#section'
+    ```
+    @property up.Request#hash
+    @param {string} hash
+    @stable
+     */
     /***
     [Parameters](/up.Params) that should be sent as the request's payload.
@@ -9351,7 +9461,9 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
-    The CSS selector that will be sent as an `X-Up-Target` header.
+    The CSS selector targeted by this request.
+    The selector will be sent as an `X-Up-Target` header.
     @property up.Request#target
     @param {string} target
@@ -9360,7 +9472,10 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
-    The CSS selector that will be sent as an `X-Up-Fail-Target` header.
+    The CSS selector targeted by this request in case the server responds
+    with an [error code](/server-errors).
+    The selector will be sent as an `X-Up-Fail-Target` header.
     @property up.Request#failTarget
     @param {string} failTarget
@@ -9371,7 +9486,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
     An object of additional HTTP headers.
-    Note that Unpoly will by default send a number of custom request headers.
+    Unpoly will by default send a number of custom request headers.
     See `up.protocol` and `up.network.config.metaKeys` for details.
     @property up.Request#headers
@@ -9407,25 +9522,71 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
-    TODO: Docs
+    The [context](/contact) of the layer targeted by this request.
+    The context object will be sent as an `X-Up-Context` header.
     @property up.Request#context
     @param {Object} context
-    @stable
+    @experimental
      */
     /***
-    TODO: Docs
+    The [context](/contact) of the layer targeted by this request in case the server responds with an [error code](/server-errors).
+    The context object will be sent as an `X-Up-Fail-Context` header.
     @property up.Request#failContext
     @param {Object} failContext
-    @stable
+    @experimental
+     */
+    /***
+    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
+    @param {up.Layer} layer
+    @experimental
+     */
+    /***
+    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
+    @param {up.Layer} layer
+    @experimental
+     */
+    /***
+    The element that triggered the request.
+    For example, when this request was triggered by a click on a link, the lonk
+    element is set as the `{ origin }`.
+    To prevent memory leaks, this property is removed shortly after the response is received.
+    @property up.Request#origin
+    @param {Element} origin
+    @experimental
      */
     /***
-    TODO: Docs
+    The [mode](/up.Layer.prototype.mode) of the layer targeted by this request.
+    The value will be sent as an `X-Up-Mode` header.
     @property up.Request#mode
     @param {string} mode
@@ -9434,7 +9595,9 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
-    TODO: Docs
+    The [mode](/up.Layer.prototype.mode) of the layer targeted by this request in case the server responds with an [error code](/server-errors).
+    The value will be sent as an `X-Up-Fail-Mode` header.
     @property up.Request#failMode
     @param {string} failMode
@@ -9443,7 +9606,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
-    TODO: Docs
+    The format in which the [request params](/up.Layer.prototype.params) will be encoded.
     @property up.Request#contentType
     @param {string} contentType
@@ -9452,13 +9615,22 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     /***
-    TODO: Docs
+    The payload that the request will encode into its body.
+    By default Unpoly will build a payload from the given `{ params }` option.
     @property up.Request#payload
     @param {string} payload
     @stable
      */
+    /***
+    @property up.Request#preload
+    @param {boolean} preload
+    @experimental
+     */
     Request.prototype.keys = function() {
       return ['method', 'url', 'hash', 'params', 'target', 'failTarget', 'headers', 'timeout', 'preload', 'cache', 'clearCache', 'layer', 'mode', 'context', 'failLayer', 'failMode', 'failContext', 'origin', 'solo', 'queueTime', 'wrapMethod', 'contentType', 'payload', 'onQueued'];
     };
@@ -9514,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() {
@@ -9601,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();
@@ -10180,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
@@ -10292,6 +10496,14 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     @experimental
      */
+    /***
+    Changes to the current [context](/context) as [set by the server](/X-Up-Context).
+    @property up.Response#context
+    @experimental
+     */
     Response.prototype.keys = function() {
       return ['method', 'url', 'text', 'status', 'request', 'xhr', 'target', 'title', 'acceptLayer', 'dismissLayer', 'eventPlans', 'context', 'clearCache', 'headers'];
     };
@@ -10838,7 +11050,8 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
 }).call(this);
 (function() {
-  var e, u;
+  var e, u,
+    bind = function(fn, me){ return function(){ return fn.apply(me, arguments); }; };
   u = up.util;
@@ -10846,6 +11059,8 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
   up.Tether = (function() {
     function Tether(options) {
+      this.sync = bind(this.sync, this);
+      this.scheduleSync = bind(this.scheduleSync, this);
       var base;
       if (typeof (base = up.migrate).handleTetherOptions === "function") {
         base.handleTetherOptions(options);
@@ -11147,37 +11362,26 @@ 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:`.
-```javascript
-document.addEventListener('up:modal:opened', (event) => {
-  console.log('A new modal has just opened!')
-})
-```
-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.
+Most Unpoly features emit events that are prefixed with `up:`.
-\#\#\# Preventing events
+Unpoly's own events are documented in their respective modules, for example:
-You can prevent most present form events by calling `preventDefault()`:
+| Event                 | Module             |
+|-----------------------|--------------------|
+| `up:link:follow`      | `up.link`          |
+| `up:form:submit`      | `up.form`          |
+| `up:layer:open`       | `up.layer`         |
+| `up:request:late`     | `up.network`       |
-```javascript
-document.addEventListener('up:modal:open', (event) => {
-  if (event.url == '/evil') {
-    // Prevent the modal from opening
-    event.preventDefault()
-  }
-})
-```
+@see up.on
+@see up.emit
 @module up.event
  */
@@ -11317,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).
@@ -11333,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
@@ -11424,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
      */
@@ -11680,8 +11888,12 @@ document.addEventListener('up:modal:open', (event) => {
     This hyperlink will emit an `user:select` event when clicked:
-    ```
-    <a href='/users/5" up-emit='user:select' up-emit-props='{ "id": 5, "firstName": "Alice" }'>Alice</a>
+    ```html
+    <a href='/users/5'
+      up-emit='user:select'
+      up-emit-props='{ "id": 5, "firstName": "Alice" }'>
+      Alice
+    </a>
     <script>
       up.on('a', 'user:select', function(event) {
@@ -11696,6 +11908,7 @@ document.addEventListener('up:modal:open', (event) => {
       The type of the event to be emitted.
     @param [up-emit-props='{}']
       The event properties, serialized as JSON.
+    @stable
      */
     executeEmitAttr = function(event, element) {
       var eventProps, eventType, forkedEvent;
@@ -11764,7 +11977,7 @@ There are existing implementations for various web frameworks:
 - [Roda](https://github.com/adam12/roda-unpoly)
 - [Rack](https://github.com/adam12/rack-unpoly) (Sinatra, Padrino, Hanami, Cuba, ...)
 - [Phoenix](https://elixirforum.com/t/unpoly-a-framework-like-turbolinks/3614/15) (Elixir)
-- [PHP](https://github.com/adam12/rack-unpoly) (Symfony, Laravel, Stack)
+- [PHP](https://github.com/webstronauts/php-unpoly) (Symfony, Laravel, Stack)
 @module up.protocol
  */
@@ -11987,68 +12200,35 @@ There are existing implementations for various web frameworks:
     The timestamp must be explicitely set by the user as an `[up-time]` attribute on the fragment.
     It should indicate the time when the fragment's underlying data was last changed.
-    Its value is the number of seconds elapsed since the [Unix epoch](https://en.wikipedia.org/wiki/Unix_time).
-    If no timestamp is known, Unpoly will send a value of zero (`X-Up-Reload-From-Time: 0`).
-    \#\#\# Example
+    See `[up-time]` for a detailed example.
-    You may timestamp your fragments with an `[up-time]` attribute to indicate when the underlying data
-    was last changed. For instance, when the last message in a list was received from December 24th, 1:51:46 PM UTC:
+    \#\#\# Format
-    ```html
-    <div class="messages" up-time="1608730818">
-      ...
-    </div>
-    ```
+    The time is encoded is the number of seconds elapsed since the [Unix epoch](https://en.wikipedia.org/wiki/Unix_time).
-    When reloading the `.messages` fragment, Unpoly will echo that timestamp in an `X-Up-Reload-From-Time` 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
     X-Up-Reload-From-Time: 1608730818
     ```
-    \#\# Cheap polling responses
+    If no timestamp is known, Unpoly will send a value of zero (`X-Up-Reload-From-Time: 0`).
-    A use case for the `X-Up-Reload-From-Time` header is to avoid rendering unchanged content
-    while [polling](/up-poll).
+    @header X-Up-Reload-From-Time
+    @stable
+     */
+    contextFromXHR = function(xhr) {
+      return extractHeader(xhr, 'context', JSON.parse);
+    };
+    /***
+    This request header contains the targeted layer's [context](/context), serialized as JSON.
-    The server can compare the time from the request with the time of the last data update.
-    If no more recent data is available, the server can [render nothing](/X-Up-Target):
+    The user may choose to not send this header by configuring
+    `up.network.config.requestMetaKeys`.
-    ```ruby
-    class MessagesController < ApplicationController
-      def index
-        if up.reload_from_time == current_user.last_message_at
-          up.render_nothing
-        else
-          @messages = current_user.messages.order(time: :desc).to_a
-          render 'index'
-        end
-      end
-    end
-    ```
-    Only rendering when needed saves <b>CPU time</b> on your server, which spends most of its response time rendering HTML.
-    This also reduces the <b>bandwidth cost</b> for a request/response exchange to **~1 KB**.
-    @header X-Up-Reload-From-Time
-    @stable
-     */
-    contextFromXHR = function(xhr) {
-      return extractHeader(xhr, 'context', JSON.parse);
-    };
-    /***
-    This request header contains the targeted layer's [context](/up.context), serialized as JSON.
-    The user may choose to not send this header by configuring
-    `up.network.config.requestMetaKeys`.
-    \#\#\# Example
+    \#\#\# Example
     ```http
     X-Up-Context: { "lives": 3 }
@@ -12084,11 +12264,11 @@ There are existing implementations for various web frameworks:
     the request was in flight will get overridden by the server-provided context.
     @header X-Up-Context
-    @stable
+    @experimental
      */
     /***
-    This request header contains the [context](/up.context) of the layer
+    This request header contains the [context](/context) of the layer
     targeted for a failed fragment update, serialized as JSON.
     A fragment update is considered *failed* if the server responds with a
@@ -12107,7 +12287,7 @@ There are existing implementations for various web frameworks:
     ```
     @header X-Up-Fail-Context
-    @stable
+    @experimental
      */
     /***
@@ -12267,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
@@ -12313,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
@@ -12425,10 +12605,12 @@ There are existing implementations for various web frameworks:
     Configures strings used in the optional [server protocol](/up.protocol).
     @property up.protocol.config
     @param {string} [config.csrfHeader='X-CSRF-Token']
       The name of the HTTP header that will include the
       [CSRF token](https://en.wikipedia.org/wiki/Cross-site_request_forgery#Synchronizer_token_pattern)
       for AJAX requests.
     @param {string|Function(): string} [config.csrfParam]
       The `name` of the hidden `<input>` used for sending a
       [CSRF token](https://en.wikipedia.org/wiki/Cross-site_request_forgery#Synchronizer_token_pattern) when
@@ -12440,7 +12622,10 @@ There are existing implementations for various web frameworks:
       Defaults to the `content` attribute of a `<meta>` tag named `csrf-param`:
-          <meta name="csrf-param" content="authenticity_token" />
+      ```html
+      <meta name="csrf-param" content="authenticity_token" />
+      ```
     @param {string|Function(): string} [config.csrfToken]
       The [CSRF token](https://en.wikipedia.org/wiki/Cross-site_request_forgery#Synchronizer_token_pattern)
       to send for unsafe requests. The token will be sent as either a HTTP header (for AJAX requests)
@@ -12451,7 +12636,10 @@ There are existing implementations for various web frameworks:
       Defaults to the `content` attribute of a `<meta>` tag named `csrf-token`:
-          <meta name='csrf-token' content='secret12345'>
+      ```
+      <meta name='csrf-token' content='secret12345'>
+      ```
     @param {string} [config.methodParam='_method']
       The name of request parameter containing the original request method when Unpoly needs to wrap
       the method.
@@ -12530,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
  */
@@ -12559,11 +12748,14 @@ You can activate logging by calling [`up.log.enable()`](/up.log.enable).
       Debugging information includes which elements are being [compiled](/up.syntax)
       and which [events](/up.event) are being emitted.
       Note that errors will always be printed, regardless of this setting.
-    @internal
+    @param {boolean} [options.banner=true]
+      Print the Unpoly banner to the developer console.
+    @stable
      */
     config = new up.Config(function() {
       return {
-        enabled: sessionStore.get('enabled')
+        enabled: sessionStore.get('enabled'),
+        banner: true
       };
     });
     reset = function() {
@@ -12621,6 +12813,9 @@ You can activate logging by calling [`up.log.enable()`](/up.log.enable).
     };
     printBanner = function() {
       var color, logo, text;
+      if (!config.banner) {
+        return;
+      }
       logo = " __ _____  ___  ___  / /_ __\n" + ("/ // / _ \\/ _ \\/ _ \\/ / // /  " + up.version + "\n") + "\\___/_//_/ .__/\\___/_/\\_. / \n" + "        / /            / /\n\n";
       text = "";
       if (!up.migrate.loaded) {
@@ -12638,7 +12833,7 @@ You can activate logging by calling [`up.log.enable()`](/up.log.enable).
         return console.log(logo + text);
       }
     };
-    up.on('up:framework:boot', printBanner);
+    up.on('up:app:boot', printBanner);
     up.on('up:framework:reset', reset);
     setEnabled = function(value) {
       sessionStore.set('enabled', value);
@@ -12646,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.
@@ -12661,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.
@@ -12703,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) {
@@ -12756,20 +12953,11 @@ You can activate logging by calling [`up.log.enable()`](/up.log.enable).
 Custom JavaScript
 =================
-Every app needs a way to pair JavaScript snippets with certain HTML elements,
-in order to integrate libraries or implement custom behavior.
+The `up.syntax` package lets you pair HTML elements with JavaScript behavior.
-Unpoly lets you organize your JavaScript snippets using [compilers](/up.compiler).
-For instance, to activate the [Masonry](http://masonry.desandro.com/) library for every element
-with a `grid` class, use this compiler:
-    up.compiler('.grid', function(element) {
-      new Masonry(element, { itemSelector: '.grid--item' })
-    })
-The compiler function will be called on matching elements when the page loads
-or when a matching fragment is [inserted via AJAX](/up.link) later.
+@see up.compiler
+@see [up-data]
+@see up.macro
 @module up.syntax
  */
@@ -12804,14 +12992,17 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
     Use compilers to activate your custom Javascript behavior on matching
     elements.
-    You should migrate your [`DOMContentLoaded`](https://api.jquery.com/ready/)
+    You should migrate your [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/API/Window/DOMContentLoaded_event)
     callbacks to compilers. This will make sure they run both at page load and
     when a new fragment is inserted later.
-    It will also organize your JavaScript snippets by selector of affected elements.
+    See [Making JavaScripts work with fragment updates](/legacy-scripts) for advice
+    on migrating legacy scripts.
+    It will also organize your JavaScript snippets by selector.
     \#\#\# Example
-    This jQuery compiler will insert the current time into a
+    This compiler will insert the current time into a
     `<div class='current-time'></div>`:
     ```js
@@ -12872,55 +13063,34 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
     An alternative way to register a destructor function is `up.destructor()`.
-    \#\#\# Attaching structured data
+    \#\#\# Passing parameters to a compiler
-    In case you want to attach structured data to the event you're observing,
-    you can serialize the data to JSON and put it into an `[up-data]` attribute.
-    For instance, a container for a [Google Map](https://developers.google.com/maps/documentation/javascript/tutorial)
-    might attach the location and names of its marker pins:
+    Use the `[up-data]` attribute to attach structured data to a DOM element.
+    The data will be parsed and passed to your compiler function.
-    ```html
-    <div class='google-map' up-data='[
-      { "lat": 48.36, "lng": 10.99, "title": "Friedberg" },
-      { "lat": 48.75, "lng": 11.45, "title": "Ingolstadt" }
-    ]'></div>
-    ```
-    The JSON will be parsed and handed to your compiler as a second argument:
-    ```js
-    up.compiler('.google-map', function(element, pins) {
-      var map = new google.maps.Map(element)
+    Alternatively your compiler may access attributes for the compiled element
+    via the standard [`Element#getAttribute()`](https://developer.mozilla.org/en-US/docs/Web/API/Element/getAttribute)
+    method.
-      pins.forEach(function(pin) {
-        var position = new google.maps.LatLng(pin.lat, pin.lng)
-        new google.maps.Marker({
-          position: position,
-          map: map,
-          title: pin.title
-        })
-      })
-    })
-    ```
+    Unpoly also provides utility functions to read an element attribute and
+    cast it to a given type:
-    @see legacy-scripts
+    - `up.element.booleanAttr(element, attr)`
+    - `up.element.numberAttr(element, attr)`
+    - `up.element.jsonAttr(element, attr)`
     @function up.compiler
     @param {string} selector
       The selector to match.
     @param {number} [options.priority=0]
       The priority of this compiler.
       Compilers with a higher priority are run first.
       Two compilers with the same priority are run in the order they were registered.
     @param {boolean} [options.batch=false]
       If set to `true` and a fragment insertion contains multiple
-      elements matching the selector, `compiler` is only called once
-      with a jQuery collection containing all matching elements.
-    @param {boolean} [options.keep=false]
-      If set to `true` compiled fragment will be [persisted](/up-keep) during
-      fragment updates.
-      This has the same effect as setting an `up-keep` attribute on the element.
+      elements matching `selector`, the `compiler` function is only called once
+      with all these elements.
     @param {Function(element, data)} compiler
       The function to call when a matching element is inserted.
@@ -12957,10 +13127,12 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
     This jQuery compiler will insert the current time into a
     `<div class='current-time'></div>`:
-        up.$compiler('.current-time', function($element) {
-          var now = new Date()
-          $element.text(now.toString())
-        })
+    ```js
+    up.$compiler('.current-time', function($element) {
+      var now = new Date()
+      $element.text(now.toString())
+    })
+    ```
     @function up.$compiler
     @param {string} selector
@@ -12984,33 +13156,40 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
     /***
     Registers a [compiler](/up.compiler) that is run before all other compilers.
-    Use `up.macro()` to register a compiler that sets multiple Unpoly attributes.
+    A macro lets you set UJS attributes that will be compiled afterwards.
+    If you want default attributes for *every* link and form, consider customizing your
+    [navigation options](/navigation).
     \#\#\# Example
     You will sometimes find yourself setting the same combination of UJS attributes again and again:
-        <a href="/page1" up-target=".content" up-transition="cross-fade" up-duration="300">Page 1</a>
-        <a href="/page2" up-target=".content" up-transition="cross-fade" up-duration="300">Page 2</a>
-        <a href="/page3" up-target=".content" up-transition="cross-fade" up-duration="300">Page 3</a>
+    ```html
+    <a href="/page1" up-layer="new modal" up-class="warning" up-animation="shake">Page 1</a>
+    <a href="/page1" up-layer="new modal" up-class="warning" up-animation="shake">Page 1</a>
+    <a href="/page1" up-layer="new modal" up-class="warning" up-animation="shake">Page 1</a>
+    ```
-    We would much rather define a new `[content-link]` attribute that let's us
+    We would much rather define a new `[smooth-link]` attribute that let's us
     write the same links like this:
-        <a href="/page1" content-link>Page 1</a>
-        <a href="/page2" content-link>Page 2</a>
-        <a href="/page3" content-link>Page 3</a>
+    ```html
+    <a href="/page1" smooth-link>Page 1</a>
+    <a href="/page2" smooth-link>Page 2</a>
+    <a href="/page3" smooth-link>Page 3</a>
+    ```
     We can define the `[content-link]` attribute by registering a macro that
     sets the `[up-target]`, `[up-transition]` and `[up-duration]` attributes for us:
-        up.macro('[content-link]', function(link) {
-          link.setAttribute('up-target', '.content')
-          link.setAttribute('up-transition', 'cross-fade')
-          link.setAttribute('up-duration', '300')
-        })
-    Examples for built-in macros are [`a[up-dash]`](/a-up-dash) and [`[up-expand]`](/up-expand).
+    ```
+    up.macro('[smooth-link]', function(link) {
+      link.setAttribute('up-target', '.content')
+      link.setAttribute('up-transition', 'cross-fade')
+      link.setAttribute('up-duration', '300')
+    })
+    ```
     @function up.macro
     @param {string} selector
@@ -13043,13 +13222,15 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
     \#\#\# Example
-        up.$macro('[content-link]', function($link) {
-          $link.attr(
-            'up-target': '.content',
-            'up-transition': 'cross-fade',
-            'up-duration':'300'
-          )
-        })
+    ```js
+    up.$macro('[content-link]', function($link) {
+      $link.attr(
+        'up-target': '.content',
+        'up-transition': 'cross-fade',
+        'up-duration':'300'
+      )
+    })
+    ```
     @function up.$macro
     @param {string} selector
@@ -13111,6 +13292,7 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
     /***
     Applies all compilers on the given element and its descendants.
     Unlike [`up.hello()`](/up.hello), this doesn't emit any events.
     @function up.syntax.compile
@@ -13139,8 +13321,8 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
     })
     ```
-    An alternative way to register a destructor function is to `return`
-    it from your compiler function.
+    An alternative way to register a destructor function is to
+    [`return` it from your compiler function](/up.compiler#cleaning-up-after-yourself).
     @function up.destructor
     @param {Element} element
@@ -13164,6 +13346,7 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
     /***
     Runs any destructor on the given fragment and its descendants in the same layer.
     Unlike [`up.destroy()`](/up.destroy), this does not emit any events
     and does not remove the element from the DOM.
@@ -13182,20 +13365,23 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
     };
     /***
-    Checks if the given element has an [`up-data`](/up-data) attribute.
-    If yes, parses the attribute value as JSON and returns the parsed object.
+    Returns the given element's `[up-data]`, parsed as a JavaScript object.
-    Returns `undefined` if the element has no `up-data` attribute.
+    Returns `undefined` if the element has no `[up-data]` attribute.
     \#\#\# Example
     You have an element with JSON data serialized into an `up-data` attribute:
-        <span class='person' up-data='{ "age": 18, "name": "Bob" }'>Bob</span>
+    ```html
+    <span class='person' up-data='{ "age": 18, "name": "Bob" }'>Bob</span>
+    ```
     Calling `up.syntax.data()` will deserialize the JSON string into a JavaScript object:
-        up.syntax.data('.person') // returns { age: 18, name: 'Bob' }
+    ```js
+    up.syntax.data('.person') // returns { age: 18, name: 'Bob' }
+    ```
     @function up.data
     @param {string|Element|jQuery} element
@@ -13208,39 +13394,49 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
      */
     /***
-    If an element with an `up-data` attribute enters the DOM,
+    Attaches structured data to an element, to be consumed by a compiler.
+    If an element with an `[up-data]` attribute enters the DOM,
     Unpoly will parse the JSON and pass the resulting object to any matching
-    [`up.compiler()`](/up.compiler) handlers.
+    [`up.compiler()`](/up.compiler) functions.
+    \#\#\# Example
     For instance, a container for a [Google Map](https://developers.google.com/maps/documentation/javascript/tutorial)
     might attach the location and names of its marker pins:
-        <div class='google-map' up-data='[
-          { "lat": 48.36, "lng": 10.99, "title": "Friedberg" },
-          { "lat": 48.75, "lng": 11.45, "title": "Ingolstadt" }
-        ]'></div>
+    ```html
+    <div class='google-map' up-data='[
+      { "lat": 48.36, "lng": 10.99, "title": "Friedberg" },
+      { "lat": 48.75, "lng": 11.45, "title": "Ingolstadt" }
+    ]'></div>
+    ```
     The JSON will be parsed and handed to your compiler as a second argument:
-        up.compiler('.google-map', function(element, pins) {
-          var map = new google.maps.Map(element)
-          pins.forEach(function(pin) {
-            var position = new google.maps.LatLng(pin.lat, pin.lng)
-            new google.maps.Marker({
-              position: position,
-              map: map,
-              title: pin.title
-            })
-          })
+    ```js
+    up.compiler('.google-map', function(element, pins) {
+      var map = new google.maps.Map(element)
+      pins.forEach(function(pin) {
+        var position = new google.maps.LatLng(pin.lat, pin.lng)
+        new google.maps.Marker({
+          position: position,
+          map: map,
+          title: pin.title
         })
+      })
+    })
+    ```
     Similarly, when an event is triggered on an element annotated with
     [`up-data`], the parsed object will be passed to any matching
     [`up.on()`](/up.on) handlers.
-        up.on('click', '.google-map', function(event, element, pins) {
-          console.log("There are %d pins on the clicked map", pins.length)
-        })
+    ```js
+    up.on('click', '.google-map', function(event, element, pins) {
+      console.log("There are %d pins on the clicked map", pins.length)
+    })
+    ```
     @selector [up-data]
     @param up-data
@@ -13293,9 +13489,10 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
 History
 ========
-In an Unpoly app, every page has an URL.
+The `up.history` module helps you work with the browser history.
-[Fragment updates](/up.link) automatically update the URL.
+@see up.history.location
+@see up:location:changed
 @module up.history
  */
@@ -13320,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
@@ -13429,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.
@@ -13463,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
@@ -13536,9 +13733,11 @@ In an Unpoly app, every page has an URL.
       register = function() {
         window.history.scrollRestoration = 'manual';
         window.addEventListener('popstate', pop);
-        return replace(currentLocation(), {
-          event: false
-        });
+        if (up.protocol.initialRequestMethod() === 'GET') {
+          return replace(currentLocation(), {
+            event: false
+          });
+        }
       };
       if (typeof jasmine !== "undefined" && jasmine !== null) {
         return register();
@@ -13601,31 +13800,48 @@ In an Unpoly app, every page has an URL.
   })();
 }).call(this);
+(function() {
+  var e, u,
+    slice = [].slice;
-/***
-Fragment update API
-===================
-The `up.fragment` module exposes a high-level Javascript API to [update](/up.replace) or
-[destroy](/up.destroy) page fragments.
-Fragments are [compiled](/up.compiler) elements that can be updated from a server URL.
-They also exist on a layer (page, modal, popup).
+  u = up.util;
-Most of Unpoly's functionality (like [fragment links](/up.link) or [modals](/up.modal))
-is built from `up.fragment` functions. You may use them to extend Unpoly from your
-[custom Javascript](/up.syntax).
+  e = up.element;
-@module up.fragment
- */
-(function() {
-  var slice = [].slice;
+  /***
+  Fragment API
+  ===========
+  The `up.fragment` module offers a high-level JavaScript API to work with DOM elements.
+  A fragment is an element with some additional properties that are useful in the context of
+  a server-rendered web application:
+  - Fragments are [identified by a CSS selector](/up.fragment.toTarget), like a `.class` or `#id`.
+  - Fragments are usually updated by a [link](/a-up-follow) for [form](/form-up-submits) that targets their selector.
+    When the server renders HTML with a matching element, the fragment is swapped with a new version.
+  - 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 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).
+  For low-level DOM utilities that complement the browser's native API, see `up.element`.
+  @see up.render
+  @see up.navigate
+  @see up.destroy
+  @see up.reload
+  @see up.fragment.get
+  @see up.hello
+  @module up.fragment
+   */
   up.fragment = (function() {
-    var CSS_HAS_SUFFIX_PATTERN, closest, config, contains, destroy, e, emitFragmentDestroyed, emitFragmentInserted, emitFragmentKeep, emitFragmentKept, emitFromKeepPlan, expandTargets, failKey, getAll, getDumb, getSmart, getSubtree, hasAutoHistory, hello, isDestroying, isGoodClassForTarget, isNotDestroying, markFragmentAsDestroying, matches, navigate, parseSelector, parseTargetAndOptions, reload, render, renderLocalContent, renderRemoteContent, reset, resolveOriginReference, sourceOf, successKey, timeOf, toTarget, u, visit;
-    u = up.util;
-    e = up.element;
     /***
     Configures defaults for fragment updates.
@@ -13671,7 +13887,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
       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' }`.
@@ -13683,7 +13899,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
       - 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.
@@ -13691,7 +13907,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
       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
@@ -13699,6 +13915,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     @stable
      */
+    var CSS_HAS_SUFFIX_PATTERN, closest, config, contains, destroy, emitFragmentDestroyed, emitFragmentInserted, emitFragmentKeep, emitFragmentKept, emitFromKeepPlan, expandTargets, failKey, getAll, getDumb, getSmart, getSubtree, hasAutoHistory, hello, isDestroying, isGoodClassForTarget, isNotDestroying, markFragmentAsDestroying, matches, navigate, parseSelector, parseTargetAndOptions, reload, render, renderLocalContent, renderRemoteContent, reset, resolveOriginReference, sourceOf, successKey, timeOf, toTarget, visit;
     config = new up.Config(function() {
       return {
         badTargetClasses: [/^up-/],
@@ -13719,13 +13936,8 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
         autoScroll: ['hash', 'layer-if-main']
       };
     });
-    Object.defineProperty(config, 'mainTargets', {
-      get: function() {
-        return up.layer.config.any.mainTargets;
-      },
-      set: function(value) {
-        return up.layer.config.any.mainTargets = value;
-      }
+    u.delegate(config, 'mainTargets', function() {
+      return up.layer.config.any;
     });
     reset = function() {
       return config.reset();
@@ -13779,6 +13991,74 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
       return e.closestAttr(element, 'up-time') || '0';
     };
+    /***
+    Sets the time when the fragment's underlying data was last changed.
+    This can be used to avoid rendering unchanged HTML when [reloading](/up.reload)
+    a fragment. This saves <b>CPU time</b> and reduces the <b>bandwidth cost</b> for a
+    request/response exchange to **~1 KB**.
+    \#\# Example
+    Let's say we display a list of recent messages.
+    We use the `[up-poll]` attribute to reload the `.messages` fragment every 30 seconds:
+    ```html
+    <div class="messages" up-poll>
+      ...
+    </div>
+    ```
+    The list is now always up to date. But most of the time there will not be new messages,
+    and we waste resources sending the same unchanged HTML from the server.
+    We can improve this by setting an `[up-time]` attribute and the message list.
+    The attribute value is the time of the most recent message.
+    The time is encoded as the number of seconds since [Unix epoch](https://en.wikipedia.org/wiki/Unix_time).
+    When, for instance, the last message in a list was received from December 24th, 1:51:46 PM UTC,
+    we use the following HTML:
+    ```html
+    <div class="messages" up-time="1608730818" up-poll>
+      ...
+    </div>
+    ```
+    When reloading Unpoly will echo the `[up-time]` timestamp in an `X-Up-Reload-From-Time` header:
+    ```http
+    X-Up-Reload-From-Time: 1608730818
+    ```
+    The server can compare the time from the request with the time of the last data update.
+    If no more recent data is available, the server can render nothing and respond with
+    an [`X-Up-Target: :none`](/X-Up-Target) header.
+    Here is an example with [unpoly-rails](https://unpoly.com/install/rails):
+    ```ruby
+    class MessagesController < ApplicationController
+      def index
+        if up.reload_from_time == current_user.last_message_at
+          up.render_nothing
+        else
+          @messages = current_user.messages.order(time: :desc).to_a
+          render 'index'
+        end
+      end
+    end
+    ```
+    @selector [up-time]
+    @param {string} up-time
+      The number of seconds between the [Unix epoch](https://en.wikipedia.org/wiki/Unix_time).
+      and the time when the element's underlying data was last changed.
+    @experimental
+     */
     /***
     Sets this element's source URL for [reloading](/up.reload) and [polling](/up-poll)
@@ -13800,7 +14080,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
         </div>
     @selector [up-source]
-    @param {String} up-source
+    @param {string} up-source
       The URL from which to reload this element.
     @stable
      */
@@ -13810,7 +14090,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     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.
@@ -13871,29 +14151,32 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     @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.
@@ -13973,12 +14256,12 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
       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.
       [Overlays](/up.layer) will only change the browser URL and window title if the overlay
-      has [visible history](/up.layer.historyVisible), even with `{ history: true }`.
+      has [visible history](/up.layer.historyVisible), even when `{ history: true }` is passed.
     @param {string} [options.title]
       An explicit document title to use after rendering.
@@ -14029,11 +14312,12 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
       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]
@@ -14058,7 +14342,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
       This is only relevant when updating a layer that is not the [frontmost layer](/up.layer.front).
     @param {Object} [options.context]
-      An object that will be merged into the [context](/up.context) of the current layer once the fragment is rendered.
+      An object that will be merged into the [context](/context) of the current layer once the fragment is rendered.
     @param {boolean} [options.keep=true]
       Whether [`[up-keep]`](/up-keep) elements will be preserved in the updated fragment.
@@ -14162,7 +14446,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     @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
@@ -14192,17 +14476,19 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     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.
@@ -14216,6 +14502,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
       The server response.
     @param {Object} event.renderOptions
       Options for the `up.render()` call that will process the server response.
+    @stable
      */
     /***
@@ -14601,7 +14888,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     - The [`up.element.all()`](/up.element.get) function simply returns the all elements matching a selector
       without further filtering.
-    @function up.fragment.get
+    @function up.fragment.all
     @param {Element|jQuery} [root=document]
       The root element for the search. Only the root's children will be matched.
@@ -14836,7 +15123,8 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     \#\#\# Skipping updates when nothing changed
-    TODO: Document [up-time] and X-Up-Reload-From-Time (currently both documented in `X-Up-Reload-From-Time`).
+    You may use the `[up-time]` attribute to avoid rendering unchanged HTML when reloading
+    a fragment. See `[up-time]` for a detailed example.
     @function up.reload
     @param {string|Element|jQuery} [target]
@@ -14914,11 +15202,12 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     \#\#\# 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.element.toTarget
+    @function up.fragment.toTarget
     @param {string|Element|jQuery}
       The element for which to create a selector.
     @stable
@@ -14941,7 +15230,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
         selector = '';
         for (i = 0, len = goodClasses.length; i < len; i++) {
           klass = goodClasses[i];
-          selector += "." + klass;
+          selector += e.classSelector(klass);
         }
         return selector;
       } else {
@@ -15091,10 +15380,13 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     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
@@ -15106,6 +15398,86 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     @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.
@@ -15150,7 +15522,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     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
@@ -15247,36 +15619,39 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
   up.visit = up.fragment.visit;
+  /***
+  Returns the current [context](/context).
+  This is aliased as `up.layer.context`.
+  @property up.context
+  @param {Object} context
+    The context object.
+    If no context has been set an empty object is returned.
+  @experimental
+   */
+  u.delegate(up, 'context', function() {
+    return up.layer.current;
+  });
 }).call(this);
 /***
 Scrolling viewports
 ===================
-The `up.viewport` module controls the scroll position of scrollable containers ("viewports").
+The `up.viewport` module controls the scroll position and focus within scrollable containers ("viewports").
 The default viewport for any web application is the main document. An application may
 define additional viewports by giving the CSS property `{ overflow-y: scroll }` to any `<div>`.
+Also see documentation for the [scroll option](/scroll-option) and [focus option](focus-option).
-\#\#\# Revealing new content
-When following a [link to a fragment](/a-up-follow) Unpoly will automatically
-scroll the document's viewport to [reveal](/up.viewport) the updated content.
-You should [make Unpoly aware](/up.viewport.config#config.fixedTop) of fixed elements in your
-layout, such as navigation bars or headers. Unpoly will respect these sticky
-elements when [revealing updated fragments](/up.reveal).
-You should also [tell Unpoly](/up.viewport.config#config.viewportSelectors) when your application has more than one viewport,
-so Unpoly can pick the right viewport to scroll for each fragment update.
-\#\#\# Bootstrap integration
-When using Bootstrap integration (`unpoly-bootstrap3.js` and `unpoly-bootstrap3.css`)
-Unpoly will automatically be aware of sticky Bootstrap components such as
-[fixed navbar](https://getbootstrap.com/examples/navbar-fixed-top/).
+@see up.reveal
+@see [up-fixed=top]
 @module up.viewport
  */
@@ -15285,29 +15660,31 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
   var slice = [].slice;
   up.viewport = (function() {
-    var absolutize, allSelector, anchoredRight, autofocus, closest, config, doFocus, e, f, firstHashTarget, fixedElements, getAll, getAround, getRoot, getScrollTops, getSubtree, isNativelyFocusable, isRoot, makeFocusable, parseOptions, pureHash, reset, resetScroll, restoreScroll, reveal, revealHash, rootHasReducedWidthFromScrollbar, rootHeight, rootOverflowElement, rootSelector, rootWidth, saveScroll, scroll, scrollTopKey, scrollTops, scrollbarWidth, scrollingController, setScrollTops, tryFocus, u, userScrolled, wasChosenAsOverflowingElement;
+    var absolutize, allSelector, anchoredRight, closest, config, doFocus, e, f, firstHashTarget, fixedElements, getAll, getAround, getRoot, getScrollTops, getSubtree, isNativelyFocusable, isRoot, makeFocusable, parseOptions, pureHash, reset, resetScroll, restoreScroll, reveal, revealHash, rootHasReducedWidthFromScrollbar, rootHeight, rootOverflowElement, rootSelector, rootWidth, saveScroll, scroll, scrollTopKey, scrollTops, scrollbarWidth, scrollingController, setScrollTops, tryFocus, u, userScrolled, wasChosenAsOverflowingElement;
     u = up.util;
     e = up.element;
     f = up.fragment;
     /***
-    Configures the application layout.
+    Configures defaults for scrolling.
     @property up.viewport.config
     @param {Array} [config.viewportSelectors]
-      An array of CSS selectors that find viewports
-      (containers that scroll their contents).
+      An array of CSS selectors that match viewports.
     @param {Array} [config.fixedTop]
       An array of CSS selectors that find elements fixed to the
       top edge of the screen (using `position: fixed`).
       See [`[up-fixed="top"]`](/up-fixed-top) for details.
     @param {Array} [config.fixedBottom]
-      An array of CSS selectors that find elements fixed to the
+      An array of CSS selectors that match elements fixed to the
       bottom edge of the screen (using `position: fixed`).
       See [`[up-fixed="bottom"]`](/up-fixed-bottom) for details.
     @param {Array} [config.anchoredRight]
       An array of CSS selectors that find elements anchored to the
       right edge of the screen (using `right:0` with `position: fixed` or `position: absolute`).
       See [`[up-anchored="right"]`](/up-anchored-right) for details.
     @param {number} [config.revealSnap]
       When [revealing](/up.reveal) elements, Unpoly will scroll an viewport
@@ -15421,19 +15798,9 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
     };
     /***
-    Scroll's the given element's viewport so the first rows of the
+    Scrolls the given element's viewport so the first rows of the
     element are visible for the user.
-    \#\#\# How Unpoly finds the viewport
-    The viewport (the container that is going to be scrolled)
-    is the closest parent of the element that is either:
-    - the currently open [modal](/up.modal)
-    - an element with the attribute `[up-viewport]`
-    - the `<body>` element
-    - an element matching the selector you have configured using `up.viewport.config.viewportSelectors.push('my-custom-selector')`
     \#\#\# Fixed elements obstructing the viewport
     Many applications have a navigation bar fixed to the top or bottom,
@@ -15441,14 +15808,16 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
     You can make `up.reveal()` aware of these fixed elements
     so it can scroll the viewport far enough so the revealed element is fully visible.
-    To make `up.reveal()` aware fixed elements you can either:
+    To make `up.reveal()` aware of fixed elements you can either:
     - give the element an attribute [`up-fixed="top"`](/up-fixed-top) or [`up-fixed="bottom"`](up-fixed-bottom)
     - [configure default options](/up.viewport.config) for `fixedTop` or `fixedBottom`
     @function up.reveal
     @param {string|Element|jQuery} element
       The element to reveal.
     @param {number} [options.scrollSpeed=1]
       The speed of the scrolling motion when scrolling with `{ behavior: 'smooth' }`.
@@ -15456,6 +15825,7 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
       [native smooth scrolling](https://developer.mozilla.org/en-US/docs/Web/API/ScrollToOptions/behavior).
       Defaults to `up.viewport.config.scrollSpeed`.
     @param {string} [options.revealSnap]
       When the the revealed element would be closer to the viewport's top edge
       than this value, Unpoly will scroll the viewport to the top.
@@ -15463,35 +15833,40 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
       Set to `0` to disable snapping.
       Defaults to `up.viewport.config.revealSnap`.
     @param {string|Element|jQuery} [options.viewport]
       The scrolling element to scroll.
       Defaults to the [given element's viewport](/up.viewport.closest).
     @param {boolean} [options.top]
       Whether to scroll the viewport so that the first element row aligns
       with the top edge of the viewport.
       Defaults to `up.viewport.config.revealTop`.
     @param {string}[options.behavior='auto']
       When set to `'auto'`, this will immediately scroll to the new position.
       When set to `'smooth'`, this will scroll smoothly to the new position.
     @param {number}[options.speed]
       The speed of the scrolling motion when scrolling with `{ behavior: 'smooth' }`.
       Defaults to `up.viewport.config.scrollSpeed`.
     @param {number} [options.padding]
       The desired padding between the revealed element and the
       closest [viewport](/up.viewport) edge (in pixels).
       Defaults to `up.viewport.config.revealPadding`.
     @param {number|boolean} [options.snap]
       Whether to snap to the top of the viewport if the new scroll position
       after revealing the element is close to the top edge.
       Defaults to `up.viewport.config.revealSnap`.
-    @param {boolean} [options.peel=true]
-      Whether to close overlays obscuring the layer of `element`.
     @return {Promise}
       A promise that fulfills when the element is revealed.
@@ -15500,13 +15875,12 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
       When the scrolling is not animated, the promise will fulfill
       in the next [microtask](https://jakearchibald.com/2015/tasks-microtasks-queues-and-schedules/).
     @stable
      */
     reveal = function(element, options) {
       var motion;
-      options = u.options(options, {
-        peel: true
-      });
+      options = u.options(options);
       element = f.get(element, options);
       if (!(options.layer = up.layer.get(element))) {
         return up.error.failed.async('Cannot reveal a detached element');
@@ -15519,7 +15893,19 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
     };
     /***
-    TODO: Docs
+    Focuses the given element.
+    Focusing an element will also [reveal](/up.reveal) it, unless `{ preventScroll: true }` is passed.
+    @function up.focus
+    @param {string|Element|jQuery} element
+      The element to focus.
+    @param {[options.preventScroll=false]}
+      Whether to prevent changes to the acroll position.
+    @experimental
      */
     doFocus = function(element, options) {
       var oldScrollTop, viewport;
@@ -15544,13 +15930,6 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
       doFocus(element, options);
       return element === document.activeElement;
     };
-    autofocus = function(element, options) {
-      var autofocusElement;
-      if (autofocusElement = e.subtree(element, '[autofocus]')[0]) {
-        doDocus(autofocusElement, options);
-        return true;
-      }
-    };
     isNativelyFocusable = function(element) {
       return e.matches(element, 'a[href], button, textarea, input, select');
     };
@@ -15620,6 +15999,9 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
     Returns a list of all the viewports contained within the
     given selector or element.
+    If the given element is itself a viewport, the element is included
+    in the returned list.
     @function up.viewport.subtree
     @param {string|Element|jQuery} target
     @param {Object} options
@@ -15812,30 +16194,11 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
     The scroll positions will be associated with the current URL.
     They can later be restored by calling [`up.viewport.restoreScroll()`](/up.viewport.restoreScroll)
-    at the same URL, or by following a link with an [`[up-restore-scroll]`](/a-up-follow#up-restore-scroll)
+    at the same URL, or by following a link with an [`[scroll="restore"]`](/a-up-follow#up-restore-scroll)
     attribute.
-    Unpoly automatically saves scroll positions before a [fragment update](/up.replace)
-    you will rarely need to call this function yourself.
-    \#\#\# Examples
-    Should you need to save the current scroll positions outside of a [fragment update](/up.replace),
-    you may call:
-        up.viewport.saveScroll()
-    Instead of saving the current scroll positions for the current URL, you may also pass another
-    url or vertical scroll positionsfor each viewport:
-        up.viewport.saveScroll({
-          url: '/inbox',
-          tops: {
-            'body': 0,
-            '.sidebar', 100,
-            '.main', 320
-          }
-        })
+    Unpoly automatically saves scroll positions before [navigating](/navigation).
+    You will rarely need to call this function yourself.
     @function up.viewport.saveScroll
     @param {string} [options.location]
@@ -16162,7 +16525,6 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
       absolutize: absolutize,
       focus: doFocus,
       tryFocus: tryFocus,
-      autofocus: autofocus,
       makeFocusable: makeFocusable
     });
   })();
@@ -16181,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
@@ -16193,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?
@@ -16206,12 +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.transition
 @module up.motion
  */
 (function() {
   up.motion = (function() {
-    var animCount, 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 = {};
@@ -16229,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
@@ -16273,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
@@ -16306,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`.
@@ -16344,7 +16731,6 @@ You can define custom animations using `up.transition()` and
       var animationFn, runNow, willRun;
       element = up.fragment.get(element);
       options = u.options(options);
-      applyConfig(options);
       animationFn = findAnimationFn(animation);
       willRun = willAnimate(element, animation, options);
       if (willRun) {
@@ -16357,6 +16743,7 @@ You can define custom animations using `up.transition()` and
       }
     };
     willAnimate = function(element, animationOrTransition, options) {
+      applyConfig(options);
       return isEnabled() && !isNone(animationOrTransition) && options.duration > 0 && !e.isSingleton(element);
     };
     skipAnimate = function(element, animation) {
@@ -16365,7 +16752,6 @@ You can define custom animations using `up.transition()` and
       }
       return Promise.resolve();
     };
-    animCount = 0;
     /***
     Animates the given element's CSS properties using CSS transitions.
@@ -16415,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.
@@ -16613,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.
@@ -16659,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
@@ -16671,7 +17061,7 @@ You can define custom animations using `up.transition()` and
     If you choose to *not* use `up.animate()` and roll your own
     animation code instead, your code must honor the following contract:
-    1. It must honor the options `{ duration, easing }` if given
+    1. It must honor the options `{ duration, easing }`, if given.
     2. It must *not* remove any of the given elements from the DOM.
     3. It returns a promise that is fulfilled when the transition has ended
     4. If during the animation an event `up:motion:finish` is emitted on
@@ -16730,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;
@@ -16748,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);
@@ -16778,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]
@@ -16793,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
      */
     /***
@@ -16802,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>
     ```
@@ -16816,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);
@@ -16856,43 +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`).
+  Unpoly ships with an optimized HTTP client for fast and effective
+  communication with your server-side app.
-  If you need to make cache-aware requests from your [custom JavaScript](/up.syntax),
-  use [`up.request()`](/up.request).
+  While you can use the browser's native `fetch()` function,
+  Unpoly's `up.request()` has a number of convenience features:
-  \#\#\# Preloading links
+  - 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.
-  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.
-  \#\#\# Spinners
-  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)
+  @see up.request
+  @see up.Response
+  @see up:request:late
   @module up.network
    */
@@ -16910,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.
@@ -17013,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,
@@ -17071,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
      */
@@ -17135,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
@@ -17210,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.
+      You may also pass a [URL pattern](/url-patterns) to only clear matching requests.
-      Defaults to the result of `up.network.config.clearCache`.
+      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.
@@ -17238,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]
@@ -17293,18 +17696,8 @@ You can define custom animations using `up.transition()` and
         abortRequests(solo);
       }
       if (clearCache = options.clearCache) {
-        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);
+        return cache.clear(clearCache);
       }
-      options = parseRequestOptions(args);
-      options.preload = true;
-      return makeRequest(options);
     };
     parseRequestOptions = function(args) {
       var base, options;
@@ -17417,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]
@@ -17590,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,
@@ -17622,15 +18020,30 @@ You can define custom animations using `up.transition()` and
   Layers
   ======
-  TODO
+  Unpoly allows you to [open page fragments in an overlay](/opening-overlays). Overlays may be stacked infinitely.
+  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).
+  Layers are 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).
+  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 and a result value is communicated back to the parent layer.
+  @see a[up-layer=new]
+  @see up.layer.current
+  @see up.layer.on
+  @see up.layer.ask
   @module up.layer
    */
   up.layer = (function() {
-    var LAYER_CLASSES, OVERLAY_CLASSES, OVERLAY_MODES, anySelector, api, ask, build, closeCallbackAttr, config, handlers, isOverlayMode, mainTargets, modeConfigs, normalizeOptions, open, openCallbackAttr, optionToString, reset, stack;
+    var LAYER_CLASSES, OVERLAY_CLASSES, anySelector, api, ask, build, closeCallbackAttr, config, handlers, mainTargets, modeConfigs, normalizeOptions, open, openCallbackAttr, optionToString, reset, stack;
     OVERLAY_CLASSES = [up.Layer.Modal, up.Layer.Popup, up.Layer.Drawer, up.Layer.Cover];
-    OVERLAY_MODES = u.map(OVERLAY_CLASSES, 'mode');
     LAYER_CLASSES = [up.Layer.Root].concat(OVERLAY_CLASSES);
     /***
@@ -17669,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
@@ -17828,16 +18241,17 @@ You can define custom animations using `up.transition()` and
     });
     /***
-    TODO: Docs
+    A list of layers that are currently open.
-    @function up.layer.stack
+    The first element in the list is the [root layer](/up.layer.root).
+    The last element is the [frontmost layer](/up.layer.front).
+    @property up.layer.stack
+    @param {List<up.Layer>} stack
     @stable
      */
     stack = null;
     handlers = [];
-    isOverlayMode = function(mode) {
-      return u.contains(OVERLAY_MODES, mode);
-    };
     mainTargets = function(mode) {
       return u.flatMap(modeConfigs(mode), 'mainTargets');
     };
@@ -17961,7 +18375,7 @@ You can define custom animations using `up.transition()` and
       How the overlay may be [dismissed](/closing-overlays) by the user.
       Supported values are `'key'`, `'outside'` and `'button'`.
-      See [user dismiss controls](/closing-overlays#user-facing-dismiss-controls)
+      See [customizing dismiss controls](/closing-overlays#customizing-dismiss-controls)
       for details.
       You may enable multiple dismiss controls by passing an array or
@@ -17975,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.
@@ -18074,22 +18488,61 @@ You can define custom animations using `up.transition()` and
     };
     /***
-    TODO: Docs
-    TODO: Document that listeners may manipulate options
-    TODO: Document that it's emitted on the document
+    This event is emitted before an overlay is opened.
+    The overlay is not yet part of the [layer stack](/up.layer.stack) and has not yet been placed
+    in the DOM. Listeners may prevent this event to prevent the overlay from opening.
+    The event is emitted on the `document`.
+    \#\#\# Changing layer options
+    Listeners may inspect and manipulate options for the overlay that is about to open.
+    For example, to give overlays the CSS class `.warning` if the initial URL contains
+    the word `"confirm"`:
+    ```js
+    up.on('up:layer:open', function(event) {
+      if (event.layerOptions.url.includes('confirm')) {
+        event.layerOptions.class = 'warning'
+      }
+    })
+    ```
     @event up:layer:open
     @param {Object} event.layerOptions
+      Options for the overlay that is about to open.
+      Listeners may inspect and change the options.
+      All options for `up.layer.open()` may be used.
     @param {Element} event.origin
+      The link element that is opening the overlay.
+    @param event.preventDefault()
+      Event listeners may call this method to prevent the overlay from opening.
     @stable
      */
     /***
-    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
      */
@@ -18097,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
@@ -18133,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
@@ -18164,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
@@ -18205,12 +18659,12 @@ 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.
-      See [user dismiss controls](/closing-overlays#user-facing-dismiss-controls)
+      See [customizing dismiss controls](/closing-overlays#customizing-dismiss-controls)
       for details.
       You may enable multiple dismiss controls by passing a space-separated string.
@@ -18408,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
@@ -18457,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
@@ -18467,7 +18945,10 @@ You can define custom animations using `up.transition()` and
     If no overlay is open, an empty array is returned.
-    @function up.layer.overlays
+    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
      */
@@ -18492,9 +18973,9 @@ You can define custom animations using `up.transition()` and
     Afterwards the only remaining layer will be the [root layer](/up.layer.root).
     @function up.layer.dismissOverlays
-    @param {any} value
+    @param {any} [value]
       The dismissal value.
-    @param {Object} options
+    @param {Object} [options]
       See options for `up.layer.dismiss()`.
     @stable
      */
@@ -18505,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
      */
     /***
@@ -18523,7 +19004,7 @@ You can define custom animations using `up.transition()` and
     @function up.layer.dismiss
     @param {any} [value]
     @param {Object} [options]
-    @return
+    @stable
      */
     /***
@@ -18532,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
      */
@@ -18560,7 +19041,7 @@ You can define custom animations using `up.transition()` and
      */
     /***
-    Listens to a ([DOM event](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model/Events)
+    Listens to a [DOM event](https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model/Events)
     that originated on an element [contained](/up.Layer.prototype.contains) by the [current layer](/up.layer.current).
     This is a shortcut for `up.layer.current.on()`.
@@ -18569,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
@@ -18586,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
@@ -18601,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
@@ -18631,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.
@@ -18640,23 +19119,34 @@ You can define custom animations using `up.transition()` and
     @param {string} location
     @stable
      */
+    /***
+    The [current layer](/up.layer.current)'s [mode](/up.layer.mode)
+    which governs its appearance and behavior.
+    @property up.layer.mode
+    @param {string} mode
+    @stable
+     */
+    /***
+    The [context](/context) of the [current layer](/up.layer.current).
+    This is aliased as `up.context`.
+    @property up.layer.context
+    @param {string} context
+      The context object.
+      If no context has been set an empty object is returned.
+    @experimental
+     */
     u.delegate(api, ['accept', 'dismiss', 'isRoot', 'isOverlay', 'isFront', 'on', 'off', 'emit', 'parent', 'historyVisible', 'location', 'mode', 'context', 'element', 'contains', 'size', 'affix'], function() {
       return stack.current;
     });
     return api;
   })();
-  /***
-  TODO: Docs
-  @property up.context
-  @pram {Object} context
-   */
-  u.getter(up, 'context', function() {
-    return up.layer.context;
-  });
 }).call(this);
 /***
@@ -18729,6 +19219,11 @@ With these [`up-target`](/a-up-follow#up-target) annotations Unpoly only updates
 The JavaScript environment will persist and the user will not see a white flash while the
 new page is loading.
+@see a[up-follow]
+@see a[up-instant]
+@see a[up-preload]
+@see up.follow
 @module up.link
  */
@@ -18736,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();
@@ -18753,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
@@ -18828,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]
@@ -18837,7 +19333,7 @@ new page is loading.
     config = new up.Config(function() {
       return {
         followSelectors: combineFollowableSelectors(LINKS_WITH_REMOTE_HTML, ATTRIBUTES_SUGGESTING_FOLLOW).concat(LINKS_WITH_LOCAL_HTML),
-        noFollowSelectors: ['[up-follow=false]', 'a[rel=download]', 'a[target]', 'a[href^="#"]:not([up-content]):not([up-fragment]):not([up-document])', 'a[href^="javascript:"]'],
+        noFollowSelectors: ['[up-follow=false]', 'a[download]', 'a[target]', 'a[href^="#"]:not([up-content]):not([up-fragment]):not([up-document])', 'a[href^="javascript:"]'],
         instantSelectors: ['[up-instant]'],
         noInstantSelectors: ['[up-instant=false]', '[onclick]'],
         preloadSelectors: combineFollowableSelectors(LINKS_WITH_REMOTE_HTML, ['[up-preload]']),
@@ -18900,10 +19396,9 @@ new page is loading.
     };
     /***
-    Fetches the given link's `[href]` with JavaScript and [replaces](/up.replace) the
-    [current layer](/up.layer.current) with HTML from the response.
+    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.
@@ -18965,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
@@ -19045,7 +19556,20 @@ new page is loading.
     The event is emitted on the `<a>` element that is being followed.
-    TODO: Document that listeners may manipulate options
+    \#\#\# Changing render options
+    Listeners may inspect and manipulate [render options](/up.render) for the coming fragment update.
+    The code below will open all form-contained links in an overlay, as to not
+    lose the user's form data:
+    ```js
+    up.on('up:link:follow', function(event, link) {
+      if (link.closest('form')) {
+        event.renderOptions.layer = 'new'
+      }
+    })
+    ```
     @event up:link:follow
     @param {Element} event.target
@@ -19071,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) {
@@ -19175,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)) {
@@ -19311,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.
@@ -19333,24 +19867,9 @@ 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 replaces a CSS selector
-    on the current page with a corresponding element from the response.
+    [Follows](/up.follow) this link with JavaScript and updates a fragment with the server response.
     Following a link is considered [navigation](/navigation) by default.
@@ -19363,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
@@ -19379,7 +19898,7 @@ new page is loading.
     - `[up-transition]`
     - `[up-content]`
     - `[up-fragment]`
-    - `[up-document]'
+    - `[up-document]`
     Such a link will still be followed through Unpoly.
@@ -19400,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.
@@ -19481,12 +20000,12 @@ 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.
       [Overlays](/up.layer) will only change the browser URL and window title if the overlay
-      has [visible history](/up.layer.historyVisible), even with `{ history: true }`.
+      has [visible history](/up.layer.historyVisible), even when `[up-history=true]` is set.
     @param [up-title]
       An explicit document title to use after rendering.
@@ -19561,7 +20080,7 @@ new page is loading.
       This is only relevant when updating a layer that is not the [frontmost layer](/up.layer.front).
     @param [up-context]
-      A JSON object that will be merged into the [context](/up.context)
+      A JSON object that will be merged into the [context](/context)
       of the current layer once the fragment is rendered.
     @param [up-keep='true']
@@ -19616,12 +20135,7 @@ new page is loading.
     });
     /***
-    TODO: Explain that this generates an up:click event, works on any elements, can can be used to accelerate links
-    By adding an `up-instant` attribute to a link, the destination will be
-    fetched on `mousedown` instead of `click` (`mouseup`).
-        <a href="/users" up-follow up-instant>User list</a>
+    Follows this link on `mousedown` instead of `click`.
     This will save precious milliseconds that otherwise spent
     on waiting for the user to release the mouse button. Since an
@@ -19633,6 +20147,10 @@ new page is loading.
     navigation actions this isn't needed. E.g. popular operation
     systems switch tabs on `mousedown` instead of `click`.
+    \#\#\# Example
+        <a href="/users" up-follow up-instant>User list</a>
     \#\#\# Accessibility
     If the user activates an element using their keyboard, the `up:click` event will be emitted
@@ -19642,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.
@@ -19731,11 +20218,9 @@ new page is loading.
     });
     /***
-    Links with an `up-preload` attribute will silently fetch their target
-    when the user hovers over the click area, or when the user puts her
-    mouse/finger down (before releasing).
+    Preloads this link when the user hovers over it.
-    When the link is clicked later, the response will already be cached,
+    When the link is clicked later the response will already be cached,
     making the interaction feel instant.
     @selector a[up-preload]
@@ -19763,7 +20248,6 @@ new page is loading.
       isFollowable: isFollowable,
       shouldFollowEvent: shouldFollowEvent,
       followMethod: followMethod,
-      targetMacro: targetMacro,
       convertClicks: convertClicks,
       config: config,
       combineFollowableSelectors: combineFollowableSelectors
@@ -19778,9 +20262,12 @@ new page is loading.
 Forms
 =====
-Unpoly comes with functionality to [submit](/form-up-submit) and [validate](/input-up-validate)
-forms without leaving the current page. This means you can replace page fragments,
-open dialogs with sub-forms, etc. all without losing form state.
+The `up.form` module helps you work with non-trivial forms.
+@see form[up-submit]
+@see form[up-validate]
+@see input[up-switch]
+@see form[up-autosubmit]
 @module up.form
  */
@@ -19789,7 +20276,7 @@ open dialogs with sub-forms, etc. all without losing form state.
   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]'];
@@ -19966,8 +20453,26 @@ open dialogs with sub-forms, etc. all without losing form state.
     });
     /***
-    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.
@@ -20020,14 +20525,29 @@ open dialogs with sub-forms, etc. all without losing form state.
     /***
     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
       The `<form>` element that will be submitted.
     @param {Object} event.renderOptions
       An object with [render options](/up.render) for the fragment update
-      that will show the validation results.
       Listeners may inspect and modify these options.
     @param event.preventDefault()
@@ -20035,7 +20555,11 @@ open dialogs with sub-forms, etc. all without losing form state.
     @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();
+      }
     });
     /***
@@ -20120,10 +20644,10 @@ open dialogs with sub-forms, etc. all without losing form state.
     /***
     [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
@@ -20177,7 +20701,9 @@ open dialogs with sub-forms, etc. all without losing form state.
     \#\#\# 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
@@ -20221,6 +20747,7 @@ open dialogs with sub-forms, etc. all without losing form state.
     @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;
@@ -20333,24 +20860,51 @@ open dialogs with sub-forms, etc. all without losing form state.
         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(','));
     };
     /***
-    Forms with an `up-target` attribute are [submitted via AJAX](/up.submit)
-    instead of triggering a full page reload.
-        <form method="post" action="/users" up-target=".main">
-          ...
-        </form>
+    Submits this form via JavaScript and updates a fragment with the server response.
     The server response is searched for the selector given in `up-target`.
     The selector content is then [replaced](/up.replace) in the current page.
     The programmatic variant of this is the [`up.submit()`](/up.submit) function.
-    \#\#\# Failed submission
+    \#\#\# Example
+    ```html
+    <form method="post" action="/users" up-submit>
+      ...
+    </form>
+    ```
+    \#\#\# 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
@@ -20365,19 +20919,35 @@ open dialogs with sub-forms, etc. all without losing form state.
     [`: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
@@ -20385,7 +20955,7 @@ open dialogs with sub-forms, etc. all without losing form state.
     \#\#\# 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
@@ -20569,11 +21139,13 @@ open dialogs with sub-forms, etc. all without losing form state.
      */
     /***
-    Performs [server-side validation](/input-up-validate) when any fieldset within this form changes.
+    Validates this form on the server when any field changes and shows validation errors.
     You can configure what Unpoly considers a fieldset by adding CSS selectors to the
     `up.form.config.validateTargets` array.
+    See `input[up-validate]` for detailed documentation.
     @selector form[up-validate]
     @param up-validate
       The CSS selector to update with the server response.
@@ -20590,7 +21162,7 @@ open dialogs with sub-forms, etc. all without losing form state.
     });
     /***
-    Show or hide elements when a `<select>` or `<input>` has a given value.
+    Show or hide elements when a form field is set to a given value.
     \#\#\# Example: Select options
@@ -20710,6 +21282,15 @@ open dialogs with sub-forms, etc. all without losing form state.
         <input name="query" up-observe="showSuggestions(value)">
+    Note that the parameter name in the markup must be called `value` or it will not work.
+    The parameter name can be called whatever you want in the JavaScript, however.
+    Also note that the function must be declared on the `window` object to work, like so:
+        window.showSuggestions = function(selectedValue) {
+          console.log(`Called showSuggestions() with ${selectedValue}`);
+        }
     \#\#\# Callback context
     The script given to `[up-observe]` runs with the following context:
@@ -20784,7 +21365,7 @@ open dialogs with sub-forms, etc. all without losing form state.
     /***
     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.
@@ -20813,15 +21394,15 @@ open dialogs with sub-forms, etc. all without losing form state.
         </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
      */
     /***
-    Submits the form when *any* field changes.
+    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.
@@ -20836,7 +21417,7 @@ open dialogs with sub-forms, etc. all without losing form state.
         </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
      */
@@ -20848,6 +21429,7 @@ open dialogs with sub-forms, etc. all without losing form state.
       config: config,
       submit: submit,
       submitOptions: submitOptions,
+      isSubmittable: isSubmittable,
       observe: observe,
       validate: validate,
       autosubmit: autosubmit,
@@ -20873,44 +21455,57 @@ 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
+@see a.up-active
 @module up.feedback
  */
@@ -21212,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
@@ -21225,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
@@ -21285,8 +21880,10 @@ Once the response is received the URL will change to `/bar` and the `up-active`
 Passive updates
 ===============
-This work-in-progress package will contain functionality to
-passively receive updates from the server.
+This package contains functionality to passively receive updates from the server.
+@see [up-hungry]
+@see [up-poll]
 @module up.radio
  */
@@ -21301,13 +21898,16 @@ passively receive updates from the server.
     Configures defaults for passive updates.
     @property up.radio.config
     @param {Array<string>} [config.hungrySelectors]
       An array of CSS selectors that is replaced whenever a matching element is found in a response.
       These elements are replaced even when they were not targeted directly.
       By default this contains the [`[up-hungry]`](/up-hungry) attribute.
     @param {number} [config.pollInterval=30000]
       The default [polling](/up-poll] interval in milliseconds.
     @param {boolean|string|Function(Element)} [config.pollEnabled=true]
       Whether Unpoly will follow instructions to poll fragments, like the `[up-poll]` attribute.
@@ -21322,6 +21922,7 @@ passively receive updates from the server.
       When set to `false`, Unpoly will never allow polling.
       You may also pass a function that accepts the polling fragment and returns `true`, `false` or `'auto'`.
     @stable
      */
     config = new up.Config(function() {
@@ -21344,9 +21945,8 @@ passively receive updates from the server.
     };
     /***
-    Elements with an `[up-hungry]` attribute are [updated](/up.replace) whenever there is a
-    matching element found in a successful response. The element is replaced even
-    when it isn't targeted directly.
+    Elements with an `[up-hungry]` attribute are updated whenever the server
+    sends a matching element, even if the element isn't targeted.
     Use cases for this are unread message counters or notification flashes.
     Such elements often live in the layout, outside of the content area that is
@@ -21438,21 +22038,27 @@ passively receive updates from the server.
     Assume an application layout with an unread message counter.
     You can use `[up-poll]` to refresh the counter every 30 seconds:
-        <div class="unread-count" up-poll>
-          2 new messages
-        </div>
+    ```html
+    <div class="unread-count" up-poll>
+      2 new messages
+    </div>
+    ```
     \#\#\# Controlling the reload interval
     You may set an optional `[up-interval]` attribute to set the reload interval in milliseconds:
-        <div class="unread-count" up-poll up-interval="10000">
-          2 new messages
-        </div>
+    ```html
+    <div class="unread-count" up-poll up-interval="10000">
+      2 new messages
+    </div>
+    ```
     If the value is omitted, a global default is used. You may configure the default like this:
-        up.radio.config.pollInterval = 10000
+    ```js
+    up.radio.config.pollInterval = 10000
+    ```
     \#\#\# Controlling the source URL
@@ -21460,13 +22066,20 @@ passively receive updates from the server.
     To reload from another URL, set an `[up-source]` attribute on the polling element:
-        <div class="unread-count" up-poll up-source="/unread-count">
-          2 new messages
-        </div>
+    ```html
+    <div class="unread-count" up-poll up-source="/unread-count">
+      2 new messages
+    </div>
+    ```
     \#\#\# Skipping updates when nothing changed
-    TODO: Document [up-time] and X-Up-Reload-From-Time (currently both documented in `X-Up-Reload-From-Time`).
+    When polling a fragment periodically we want to avoid rendering unchanged content.
+    This saves <b>CPU time</b> and reduces the <b>bandwidth cost</b> for a
+    request/response exchange to **~1 KB**.
+    To achieve this we timestamp your fragments with an `[up-time]` attribute to indicate
+    when the underlying data was last changed. See `[up-time]` for a detailed example.
     @selector [up-poll]
     @param [up-interval]