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

unpoly-rails 2.0.0.pre.rc6 → 2.0.0.pre.rc11

Potentially problematic release.

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

Files changed (9) hide show

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ae929555ac3d1c4f901618fed559ec3c2d53f5117de889d72c81518e158f946
-  data.tar.gz: 4a7bbc9f22a3fab1127b6c4bf3e0f930f1a300725549367025bc50c45c6ebdca
+  metadata.gz: 16c5d23ef0ef94cd9a7cb5ef926ff4931aa1e2b19b32548c35b0fd527de83d91
+  data.tar.gz: 4748c57d0da382a24dd48f594ca3f61838387dc3fd3630da416843d8c45dc079
 SHA512:
-  metadata.gz: 3ce5945794168936c808619d4ebd3a7490355dfadd7337324d40b68f2d211fc13149c46439abf693776e27c452a02f4acee78247b4196fc60bf27f94a1856b6f
-  data.tar.gz: d9c4f06cbc704414871a006c17b6ec1b7cb4d2f76c70c091f6585dc89265fa7f7e650e376e3ba632e4f75bb04049999fe0bc6644875b950616fb6ced4246b7dd
+  metadata.gz: 4b5ff85fee318e8200aef941b878d8bdac28872ff0a46e2e2468c3c28e883065daa30f96858418f900f6566632b0d469632ec8736cca550db2aa71c97fecacf0
+  data.tar.gz: 8f51f5822089f69e36da2a3c8cf7942bec84965014f0de1ebb524aaf13288697301e8fa68c747ee4b8d89a5e623eed5768bd904a87e0989ad0490527bdca2774

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

@@ -856,6 +856,11 @@ Returns the first descendant element matching the given selector.
   });
 }).call(this);
+/***
+@module up.layer
+ */
 (function() {
   var e, u;
@@ -1178,6 +1183,26 @@ This feature is now deprecated.
 (function() {
   up.migrate.renamedProperty(up.radio.config, 'hungry', 'hungrySelectors');
+}).call(this);
+(function() {
+  var u;
+  u = up.util;
+  up.migrate.postCompile = function(elements, compiler) {
+    var element, i, keepValue, len, results, value;
+    if (keepValue = compiler.keep) {
+      up.migrate.warn('The { keep: true } option for up.compiler() has been removed. Have the compiler set [up-keep] attribute instead.');
+      value = u.isString(keepValue) ? keepValue : '';
+      results = [];
+      for (i = 0, len = elements.length; i < len; i++) {
+        element = elements[i];
+        results.push(element.setAttribute('up-keep', value));
+      }
+      return results;
+    }
+  };
 }).call(this);
 /***

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

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

data/dist/unpoly.js CHANGED Viewed

@@ -5,7 +5,7 @@
 (function() {
   window.up = {
-    version: "2.0.0-rc6"
+    version: "2.0.0-rc11"
   };
 }).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)) {
@@ -1281,6 +1302,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 +1316,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 +1395,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 +1432,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 +1448,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 +1490,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 +1505,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 +1536,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
@@ -2239,7 +2303,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 +2585,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 +2624,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 +2976,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 +3518,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 +5063,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 +5079,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) {
@@ -6259,66 +6328,45 @@ 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
-    @stable
+    @property up.Layer#historyVisible
+    @param {boolean} historyVisible
      */
     /***
-    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() {
@@ -6661,7 +6709,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,
@@ -9304,7 +9352,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
   /***
-  Instances of `up.Request` normalizes properties of an [`AJAX request`](/up.request)
+  Instances of `up.Request` normalizes properties of an [AJAX request](/up.request)
   such as the requested URL, form parameters and HTTP method.
   You can queue a request using the `up.request()` method:
@@ -9341,6 +9389,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 +9416,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 +9427,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 +9441,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 +9477,67 @@ 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
      */
     /***
-    TODO: Docs
+    The [layer](/up.layer) targeted by this request.
+    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).
+    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
+     */
+    /***
+    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 +9546,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 +9557,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 +9566,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'];
     };
@@ -10180,7 +10303,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).
+  Instances of `up.Response` describe the server response to an [AJAX request](/up.request).
   \#\#\# Example
@@ -10292,6 +10415,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 +10969,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 +10978,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);
@@ -11179,6 +11313,9 @@ document.addEventListener('up:modal:open', (event) => {
 })
 ```
+@see up.on
+@see up.emit
 @module up.event
  */
@@ -11681,7 +11818,11 @@ 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>
+    <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 +11837,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 +11906,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,53 +12129,20 @@ 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 24th, 1:51:46 PM UTC would produce the following header:
     ```http
+    X-Up-Target: .unread-count
     X-Up-Reload-From-Time: 1608730818
     ```
-    \#\# Cheap polling responses
-    A use case for the `X-Up-Reload-From-Time` header is to avoid rendering unchanged content
-    while [polling](/up-poll).
-    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):
-    ```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**.
+    If no timestamp is known, Unpoly will send a value of zero (`X-Up-Reload-From-Time: 0`).
     @header X-Up-Reload-From-Time
     @stable
@@ -12043,7 +12152,7 @@ There are existing implementations for various web frameworks:
     };
     /***
-    This request header contains the targeted layer's [context](/up.context), serialized as JSON.
+    This request header contains the targeted layer's [context](/context), serialized as JSON.
     The user may choose to not send this header by configuring
     `up.network.config.requestMetaKeys`.
@@ -12084,11 +12193,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 +12216,7 @@ There are existing implementations for various web frameworks:
     ```
     @header X-Up-Fail-Context
-    @stable
+    @experimental
      */
     /***
@@ -12425,10 +12534,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 +12551,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 +12565,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.
@@ -12559,11 +12676,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 +12741,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 +12761,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);
@@ -12756,20 +12879,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.
-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 `up.syntax` package lets you pair HTML elements with JavaScript behavior.
-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 +12918,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 +12989,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
-    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:
-    ```html
-    <div class='google-map' up-data='[
-      { "lat": 48.36, "lng": 10.99, "title": "Friedberg" },
-      { "lat": 48.75, "lng": 11.45, "title": "Ingolstadt" }
-    ]'></div>
-    ```
+    \#\#\# Passing parameters to a compiler
-    The JSON will be parsed and handed to your compiler as a second argument:
+    Use the `[up-data]` attribute to attach structured data to a DOM element.
+    The data will be parsed and passed to your compiler function.
-    ```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 +13053,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 +13082,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 +13148,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 +13218,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 +13247,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 +13272,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 +13291,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 +13320,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
@@ -13297,6 +13419,9 @@ In an Unpoly app, every page has an URL.
 [Fragment updates](/up.link) automatically update the URL.
+@see up.history.location
+@see up:location:changed
 @module up.history
  */
@@ -13536,9 +13661,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 +13728,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 functions 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.
@@ -13699,6 +13843,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 +13864,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 +13919,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 +14008,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
      */
@@ -13978,7 +14186,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
       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.
@@ -14058,7 +14266,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.
@@ -14601,7 +14809,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 +15044,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]
@@ -14918,7 +15127,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
         element.className = 'klass'
         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 +15150,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 {
@@ -15133,8 +15342,10 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     \#\#\# Shorthand
-    Instead of `:origin` you may also use `&`
-    ([like in Sass](https://sass-lang.com/documentation/file.SASS_REFERENCE.html#parent-selector)).
+    Instead of `:origin` you may also use the ampersand character (`&`).
+    You may be familiar with the ampersand from the [Sass](https://sass-lang.com/documentation/file.SASS_REFERENCE.html#parent-selector)
+    CSS preprocessor.
     @selector :origin
     @experimental
@@ -15245,36 +15456,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
  */
@@ -15283,29 +15497,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
@@ -15419,19 +15635,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,
@@ -15439,14 +15645,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' }`.
@@ -15454,6 +15662,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.
@@ -15461,35 +15670,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.
@@ -15498,13 +15712,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');
@@ -15517,7 +15730,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;
@@ -15542,13 +15767,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');
     };
@@ -15618,6 +15836,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
@@ -15810,30 +16031,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]
@@ -16160,7 +16362,6 @@ Unpoly will automatically be aware of sticky Bootstrap components such as
       absolutize: absolutize,
       focus: doFocus,
       tryFocus: tryFocus,
-      autofocus: autofocus,
       makeFocusable: makeFocusable
     });
   })();
@@ -16204,12 +16405,17 @@ and [predefined animations](/up.animate#named-animations).
 You can define custom animations using `up.transition()` and
 `up.animation()`.
+@see up.animation
+@see up.animate
+@see up.transition
+@see up.morph
 @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, registerMoveMotions, registerOpacityAnimation, registerTransition, reset, skipAnimate, swapElementsDirectly, translateCSS, u, untranslatedBox, warnIfDisabled, willAnimate;
     u = up.util;
     e = up.element;
     namedAnimations = {};
@@ -16342,7 +16548,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) {
@@ -16355,6 +16560,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) {
@@ -16363,7 +16569,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.
@@ -16669,7 +16874,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
@@ -16892,7 +17097,11 @@ You can define custom animations using `up.transition()` and
   - [Instantaneous feedback for links that are currently loading](/a.up-active)
   - [Follow links on `mousedown` instead of `click`](/a-up-instant)
-  @module up.request
+  @see up.request
+  @see up.Request
+  @see up.Response
+  @module up.network
    */
   up.network = (function() {
@@ -17620,15 +17829,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);
     /***
@@ -17826,16 +18050,17 @@ You can define custom animations using `up.transition()` and
     });
     /***
-    TODO: Docs
+    A list of layers that are currently open.
+    The first element in the list is the [root layer](/up.layer.root).
+    The last element is the [frontmost layer](/up.layer.front).
-    @function up.layer.stack
+    @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');
     };
@@ -17959,7 +18184,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
@@ -18072,13 +18297,38 @@ 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
      */
@@ -18208,7 +18458,7 @@ You can define custom animations using `up.transition()` and
     @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.
@@ -18465,7 +18715,7 @@ You can define custom animations using `up.transition()` and
     If no overlay is open, an empty array is returned.
-    @function up.layer.overlays
+    @property up.layer.overlays
     @param {Array<up.Layer>} overlays
     @stable
      */
@@ -18490,9 +18740,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
      */
@@ -18558,7 +18808,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()`.
@@ -18638,23 +18888,35 @@ You can define custom animations using `up.transition()` and
     @param {string} location
     @stable
      */
+    /***
+    The [current layer](/up.layer.current)'s mode which governs its appearance and behavior.
+    @see layer-terminology
+    @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);
 /***
@@ -18727,6 +18989,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
  */
@@ -18835,7 +19102,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]']),
@@ -18898,8 +19165,7 @@ 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)
     will be replaced. Attributes like `a[up-target]`
@@ -19043,7 +19309,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
@@ -19347,8 +19626,7 @@ new page is loading.
     };
     /***
-    [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.
@@ -19377,7 +19655,7 @@ new page is loading.
     - `[up-transition]`
     - `[up-content]`
     - `[up-fragment]`
-    - `[up-document]'
+    - `[up-document]`
     Such a link will still be followed through Unpoly.
@@ -19484,7 +19762,7 @@ new page is loading.
       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.
@@ -19559,7 +19837,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']
@@ -19614,12 +19892,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
@@ -19631,6 +19904,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
@@ -19729,11 +20006,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]
@@ -19776,9 +20051,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
  */
@@ -20025,7 +20303,6 @@ open dialogs with sub-forms, etc. all without losing form state.
       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()
@@ -20336,18 +20613,21 @@ open dialogs with sub-forms, etc. all without losing form state.
     };
     /***
-    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.
+    \#\#\# Example
+    ```html
+    <form method="post" action="/users" up-submit>
+      ...
+    </form>
+    ```
     \#\#\# Failed submission
     When the server was unable to save the form due to invalid params,
@@ -20567,11 +20847,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.
@@ -20588,7 +20870,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
@@ -20708,6 +20990,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:
@@ -20817,7 +21108,7 @@ open dialogs with sub-forms, etc. all without losing form state.
      */
     /***
-    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)
     while the autosubmitted form is loading.
@@ -20909,13 +21200,16 @@ Once the response is received the URL will change to `/bar` and the `up-active`
       <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
  */
 (function() {
   up.feedback = (function() {
-    var CLASS_ACTIVE, SELECTOR_LINK, around, aroundForOptions, config, e, findActivatableArea, linkURLs, navSelector, normalizeURL, onBrowserLocationChanged, reset, start, stop, u, updateFragment, updateLayerIfLocationChanged, updateLinks, updateLinksWithinNavs;
+    var CLASS_ACTIVE, SELECTOR_LINK, around, aroundForOptions, config, e, findActivatableArea, getLayerLocation, linkURLs, navSelector, normalizeURL, onBrowserLocationChanged, reset, start, stop, u, updateFragment, updateLayerIfLocationChanged, updateLinks, updateLinksWithinNavs;
     u = up.util;
     e = up.element;
@@ -20956,23 +21250,29 @@ Once the response is received the URL will change to `/bar` and the `up-active`
     linkURLs = function(link) {
       return link.upFeedbackURLs || (link.upFeedbackURLs = new up.LinkFeedbackURLs(link));
     };
-    updateFragment = function(fragment, options) {
-      var links;
-      if (e.closest(fragment, navSelector())) {
-        links = e.subtree(fragment, SELECTOR_LINK);
-        return updateLinks(links, options);
+    updateFragment = function(fragment) {
+      var layerOption, links;
+      layerOption = {
+        layer: up.layer.get(fragment)
+      };
+      if (up.fragment.closest(fragment, navSelector(), layerOption)) {
+        links = up.fragment.subtree(fragment, SELECTOR_LINK, layerOption);
+        return updateLinks(links, layerOption);
       } else {
-        return updateLinksWithinNavs(fragment, options);
+        return updateLinksWithinNavs(fragment, layerOption);
       }
     };
     updateLinksWithinNavs = function(fragment, options) {
       var links, navs;
-      navs = e.subtree(fragment, navSelector());
+      navs = up.fragment.subtree(fragment, navSelector(), options);
       links = u.flatMap(navs, function(nav) {
         return e.subtree(nav, SELECTOR_LINK);
       });
       return updateLinks(links, options);
     };
+    getLayerLocation = function(layer) {
+      return layer.feedbackLocation || layer.location;
+    };
     updateLinks = function(links, options) {
       var layer, layerLocation;
       if (options == null) {
@@ -20982,7 +21282,7 @@ Once the response is received the URL will change to `/bar` and the `up-active`
         return;
       }
       layer = options.layer || up.layer.get(links[0]);
-      if (layerLocation = layer.feedbackLocation) {
+      if (layerLocation = getLayerLocation(layer)) {
         return u.each(links, function(link) {
           var currentClass, i, isCurrent, len, ref;
           isCurrent = linkURLs(link).isCurrent(layerLocation);
@@ -21251,11 +21551,11 @@ Once the response is received the URL will change to `/bar` and the `up-active`
         return updateLayerIfLocationChanged(frontLayer);
       }
     };
-    up.on('up:location:changed', function(event) {
+    up.on('up:location:changed', function(_event) {
       return onBrowserLocationChanged();
     });
-    up.on('up:fragment:inserted', function(event, newFragment) {
-      return updateFragment(newFragment, event);
+    up.on('up:fragment:inserted', function(_event, newFragment) {
+      return updateFragment(newFragment);
     });
     up.on('up:layer:location:changed', function(event) {
       return updateLayerIfLocationChanged(event.layer);
@@ -21277,8 +21577,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
  */
@@ -21293,13 +21595,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.
@@ -21314,6 +21619,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() {
@@ -21336,9 +21642,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
@@ -21430,21 +21735,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
@@ -21452,13 +21763,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]