unpoly-rails 0.60.3 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d297eb1edd21bf9c288e37bef6f5ddbfc2d1282e92e5bb7bf4326c01d7ea048
-  data.tar.gz: dcf7b668e2a6ef3e41ad5e8bd5d5550588e2dcd4c922ca6876cce64f8c80b544
+  metadata.gz: 35e8d0b813a4cca7d75c07ddc4c71e86cb812603e30eaa5f0dffdde3ce0cdb7e
+  data.tar.gz: d347f58ceb2f9b96ebd6128de73fecd5452ddce462e4d6a8b204d423063a0239
 SHA512:
-  metadata.gz: 0a083415b043d5a78c7ad32f08929115aa95099f5f4246916a6f0434e466e12588a6ac9b684ab1bcbcb007f91114adf993169a2e059ce619d3a0e3a60ea4c8c1
-  data.tar.gz: 8e24600bf552ff77bcc0d2f12b68b264e3e7585cfe0113e4add4594c676d484fd748734c3399c2fe5d7866ac4f73b2d57d14b40e652f9fef7d1f59c8fccff7f1
+  metadata.gz: 5421ff4c7e59fae63661dfa909b84d4c90e307643334d0510bd1a418c820a182eb37c53d254afc211b9a59ab4debf7b9df03fb9b169c56127223c8167133543e
+  data.tar.gz: a968fe80575c7305480a96ae5898142133f62a9dfb3efb3f02e462b85ddc385da749c5a06a38bbf91ab4240513abde675bd03fb8fa5468ec8a9e4d058effbbf4

data/.ruby-version

@@ -1,2 +1 @@
-2.1.2
-
+2.3.8

data/CHANGELOG.md

@@ -6,6 +6,90 @@ Changes to this project will be documented in this file.
 You may browse a formatted and hyperlinked version of this file at <https://unpoly.com/changes>.
 
 
+1.0.0
+-----
+
+For six years Unpoly has been released under a 0.x version number. To establish the maturity and stability of the project, we're releasing today's version as 1.0.0.
+
+There are only three changes from 0.62.1:
+
+- Fix a bug where `up.util.escapeHTML()`` would not escape single quotes.
+- Unpoly will no longer wait a JavaScript execution task to boot after `DOMContentLoaded`. This may improve the stability of test suites that previously interacted with the page too soon.
+- You may now disable the Unpoly banner in the development console with `up.log.config.banner = false`. (change by @hfjallemark).
+
+This is the last release of the 0.x API line. We're tracking its code in the [`1.x-stable`](https://github.com/unpoly/unpoly/tree/1.x-stable), but expect little to no changes in the future.
+
+The next release will be [Unpoly 2](https://triskweline.de/unpoly2-slides). It will include major (but mostly backwards compatible) renovations to its API, unlocking many use cases that were not possible with Unpoly 1.
+
+
+0.62.1
+------
+
+This is another maintenance release while we're finishing [the next major version of Unpoly](https://groups.google.com/forum/#!topic/unpoly/FDdVjxbjNLg).
+
+Community members were involved in every change of this release:
+
+- [`up.submit()`](/up.submit) has a new options `{ params }`. It may be used to pass extra form [parameters](/up.Params) that will be submitted in addition to the parameters from the form. (fix by @robinvdvleuten)
+- [`a[up-modal]`](/a-up-modal) will now honor an [`[up-cache]`](/a-up-target#up-cache) attribute on the same link. (fix by @adam12)
+- Prevent destructor function from being called twice if [`up.destroy()`](/up.destroy) is called twice with the same element (reported by @kratob)
+- On devices that don't show a vertical scrollbar, users can no longer scroll the underlying page while a [modal overlay](/up.modal) is open. (reported by @msurdi)
+
+
+0.62.0
+------
+
+This release backports a number of accessibility improvements from [the next major version of Unpoly](https://groups.google.com/forum/#!topic/unpoly/FDdVjxbjNLg).
+We encourage everyone to upgrade to this release in order to better support users with visual impairments.
+
+The following changes are included:
+
+- Links with an [`[up-instant]`](/a-up-instant) attribute can now be followed with the keyboard.
+- Fragments that are being [destroyed](/up.destroy) now get an [`[aria-hidden=true]`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-hidden_attribute)
+  attribute while its disappearance is being animated. When a fragment is being swapped with a new version, the old fragment version is also
+  given `[aria-hidden=true]` while it's disappearing.
+- [Modal dialogs](/up.modal) now get an [`[aria-modal=true]`](https://a11ysupport.io/tech/aria/aria-modal_attribute) attribute.
+
+The next major version of Unpoly will include additional accessibility improvements. In particular the
+new modal ("layer") implementation will implement all best practices for accessible dialogs.
+
+
+0.61.1
+------
+
+This is a maintenance release while we're getting ready for [the next major version of Unpoly](https://groups.google.com/forum/#!topic/unpoly/FDdVjxbjNLg).
+
+- Fix a bug where [`up.destroy()`](/up.destroy) wouldn't clean up the global jQuery cache. This is only relevant when using Unpoly together with jQuery.
+- Fields outside a <form> are now recognized when they have a matching [form] attribute (fixes #85)
+- [`up.form.fields()`](/up.form.fields) now accepts a jQuery collection as a first argument, as was already documented.
+
+
+0.61.0
+------
+
+This release makes it easier to migrate to a recent version of Unpoly when your app still depends on jQuery.
+Unpoly dropped its jQuery dependency with version 0.60.0, but retains optional jQuery support through functions like
+[`up.$compiler()`](/up.$compiler) and [`up.$on()`](/up.$on). All Unpoly functions that take a native element as an
+argument may also be called with a jQuery collection as an argument.
+
+The following changes to the optional jQuery support were implemented:
+
+- In an ES6 build pipeline, Unpoly's jQuery support no longer requires `window.jQuery` to be defined before
+  Unpoly is imported into the build. You still need to define `window.jQuery`, but you may do so at any time in your
+  scripts, regardless of load order.
+- jQuery support functions like [`up.$compiler()`](/up.$compiler) now fail with a helpful message if the developer
+  forgets to define `window.jQuery`.
+
+This release also exposes some convenience functions and selectors:
+
+- New experimental function [`up.event.halt()`](/up.event.halt). It prevents the event from bubbling up the DOM.
+  It also prevents other event handlers bound on the same element. It also prevents the event's default action.
+- New experimental function [`up.form.fields()`](/up.form.fields).  It returns a list of form fields within the given element.
+- The selector [`form[up-validate]`](/form-up-validate) is now supported. It performs
+  [server-side validation](/input-up-validate) when any fieldset within this form changes. Previously only the variant
+  [`input[up-validate]`](/input-up-validate) was supported.
+
+
+
 0.60.3
 ------
 

data/README.md

@@ -31,7 +31,7 @@ Overview:
 
 Install dependencies for tests:
 
-- Install Ruby 2.1.2
+- Install Ruby 2.3.8
 - Install Bundler by running `gem install bundler`
 - `cd` into `spec_app`
 - Install dependencies by running `bundle install`

data/Rakefile

@@ -99,7 +99,7 @@ namespace :publish do
 
   desc 'Release new version to all package managers'
   task :release do
-    Rake::Task['release'].invoke
+    Rake::Task['rubygems:publish'].invoke
     Rake::Task['npm:publish'].invoke
   end
 
@@ -108,6 +108,7 @@ namespace :publish do
     puts "Now remember to:"
     puts "- update unpoly.com so user see the updated CHANGELOG and CDN link"
     puts "- send a message to the e-mail group announcing the new release"
+    puts "- tweet a link to the CHANGELOG as @unpolyjs"
   end
 
   desc 'Build artifacts, push to git and release to package managers'
@@ -116,6 +117,15 @@ namespace :publish do
 
 end
 
+namespace :rubygems do
+
+  task :publish do
+    puts 'Publishing to rubygems.org. If this seems to hang, enter your 2FA token.'
+    Rake::Task['release'].invoke
+  end
+
+end
+
 namespace :npm do
 
   task :bump_version do

data/dist/unpoly.js

@@ -5,7 +5,7 @@
 
 (function() {
   window.up = {
-    version: "0.60.3"
+    version: "1.0.0"
   };
 
 }).call(this);
@@ -595,7 +595,7 @@ to not include another library in your asset bundle.
     @stable
      */
     isJQuery = function(object) {
-      return up.browser.canJQuery() && (object instanceof jQuery);
+      return !!(object != null ? object.jquery : void 0);
     };
 
     /***
@@ -1305,7 +1305,8 @@ to not include another library in your asset bundle.
       "&": "&",
       "<": "&lt;",
       ">": "&gt;",
-      '"': '&quot;'
+      '"': '&quot;',
+      "'": '&#x27;'
     };
 
     /***
@@ -1317,7 +1318,7 @@ to not include another library in your asset bundle.
     @stable
      */
     escapeHtml = function(string) {
-      return string.replace(/[&<>"]/g, function(char) {
+      return string.replace(/[&<>"']/g, function(char) {
         return ESCAPE_HTML_ENTITY_MAP[char];
       });
     };
@@ -1898,8 +1899,10 @@ Internet Explorer 10 or lower
  */
 
 (function() {
+  var slice = [].slice;
+
   up.browser = (function() {
-    var canAnimationFrame, canConsole, canControlScrollRestoration, canCssTransition, canCustomElements, canDOMParser, canFormData, canInputEvent, canInspectFormData, canJQuery, canPromise, canPushState, isIE10OrWorse, isIE11, isSupported, navigate, popCookie, submitForm, u, url, whenConfirmed;
+    var callJQuery, canAnimationFrame, canConsole, canControlScrollRestoration, canCssTransition, canCustomElements, canDOMParser, canFormData, canInputEvent, canInspectFormData, canJQuery, canPromise, canPushState, isIE10OrWorse, isIE11, isSupported, navigate, popCookie, submitForm, u, url, whenConfirmed;
     u = up.util;
 
     /***
@@ -2038,15 +2041,15 @@ Internet Explorer 10 or lower
     canCustomElements = u.memoize(function() {
       return !!window.customElements;
     });
-    canJQuery = u.memoize(function() {
-      return !!window.jQuery;
-    });
     canAnimationFrame = u.memoize(function() {
       return 'requestAnimationFrame' in window;
     });
     canControlScrollRestoration = u.memoize(function() {
       return 'scrollRestoration' in history;
     });
+    canJQuery = function() {
+      return !!window.jQuery;
+    };
     popCookie = function(name) {
       var ref, value;
       value = (ref = document.cookie.match(new RegExp(name + "=(\\w+)"))) != null ? ref[1] : void 0;
@@ -2086,6 +2089,12 @@ Internet Explorer 10 or lower
     isSupported = function() {
       return !isIE10OrWorse() && canConsole() && canDOMParser() && canFormData() && canCssTransition() && canInputEvent() && canPromise() && canAnimationFrame();
     };
+    callJQuery = function() {
+      var args;
+      args = 1 <= arguments.length ? slice.call(arguments, 0) : [];
+      canJQuery() || up.fail("jQuery must be published as window.jQuery");
+      return jQuery.apply(null, args);
+    };
     return {
       url: url,
       navigate: navigate,
@@ -2094,11 +2103,12 @@ Internet Explorer 10 or lower
       canFormData: canFormData,
       canInspectFormData: canInspectFormData,
       canCustomElements: canCustomElements,
-      canJQuery: canJQuery,
       canControlScrollRestoration: canControlScrollRestoration,
+      canJQuery: canJQuery,
       whenConfirmed: whenConfirmed,
       isSupported: isSupported,
       popCookie: popCookie,
+      jQuery: callJQuery,
       isIE11: isIE11
     };
   })();
@@ -2346,7 +2356,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     @function up.element.closest
     @param {Element} element
       The element on which to start the search.
-    @param {string}
+    @param {string} selector
       The CSS selector to match.
     @return {Element|null|undefined} element
       The matching element.
@@ -2510,6 +2520,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
     @experimental
      */
     show = function(element) {
@@ -2548,8 +2559,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.
     @experimental
      */
@@ -2762,11 +2775,11 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
         element.className // returns 'klass'
     
     @function up.element.affix
-    @params {Element} parent
+    @param {Element} parent
       The parent to which to attach the created element.
-    @params {string} selector
+    @param {string} selector
       The CSS selector from which to create an element.
-    @params {Object} attrs
+    @param {Object} attrs
       An object of attributes to set on the created element.
     @param {Object} attrs.text
       The [text content](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent) of the created element.
@@ -3419,32 +3432,32 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
     }
 
     BodyShifter.prototype.shift = function() {
-      var anchor, body, bodyRightPadding, bodyRightShift, elementRight, elementRightShift, i, len, overflowElement, ref, results, scrollbarWidth;
-      if (!up.viewport.rootHasVerticalScrollbar()) {
-        return;
-      }
-      body = document.body;
+      var anchor, body, bodyRightPadding, bodyRightShift, elementRight, elementRightShift, i, len, overflowElement, ref, results, rootHadVerticalScrollbar, scrollbarWidth;
+      rootHadVerticalScrollbar = up.viewport.rootHasVerticalScrollbar();
       overflowElement = up.viewport.rootOverflowElement();
-      scrollbarWidth = up.viewport.scrollbarWidth();
-      bodyRightPadding = e.styleNumber(body, 'paddingRight');
-      bodyRightShift = scrollbarWidth + bodyRightPadding;
-      this.unshiftFns.push(e.setTemporaryStyle(body, {
-        paddingRight: bodyRightShift
-      }));
       this.unshiftFns.push(e.setTemporaryStyle(overflowElement, {
         overflowY: 'hidden'
       }));
-      ref = up.viewport.anchoredRight();
-      results = [];
-      for (i = 0, len = ref.length; i < len; i++) {
-        anchor = ref[i];
-        elementRight = e.styleNumber(anchor, 'right');
-        elementRightShift = scrollbarWidth + elementRight;
-        results.push(this.unshiftFns.push(e.setTemporaryStyle(anchor, {
-          right: elementRightShift
-        })));
+      if (rootHadVerticalScrollbar) {
+        body = document.body;
+        scrollbarWidth = up.viewport.scrollbarWidth();
+        bodyRightPadding = e.styleNumber(body, 'paddingRight');
+        bodyRightShift = scrollbarWidth + bodyRightPadding;
+        this.unshiftFns.push(e.setTemporaryStyle(body, {
+          paddingRight: bodyRightShift
+        }));
+        ref = up.viewport.anchoredRight();
+        results = [];
+        for (i = 0, len = ref.length; i < len; i++) {
+          anchor = ref[i];
+          elementRight = e.styleNumber(anchor, 'right');
+          elementRightShift = scrollbarWidth + elementRight;
+          results.push(this.unshiftFns.push(e.setTemporaryStyle(anchor, {
+            right: elementRightShift
+          })));
+        }
+        return results;
       }
-      return results;
     };
 
     BodyShifter.prototype.unshift = function() {
@@ -3774,7 +3787,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
 
     CompilePass.prototype.compileOneElement = function(compiler, element) {
       var compileArgs, data, destructorOrDestructors, elementArg, result;
-      elementArg = compiler.jQuery ? jQuery(element) : element;
+      elementArg = compiler.jQuery ? up.browser.jQuery(element) : element;
       compileArgs = [elementArg];
       if (compiler.length !== 1) {
         data = up.syntax.data(element);
@@ -3788,7 +3801,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
 
     CompilePass.prototype.compileBatch = function(compiler, elements) {
       var compileArgs, dataList, elementsArgs, result;
-      elementsArgs = compiler.jQuery ? jQuery(elements) : elements;
+      elementsArgs = compiler.jQuery ? up.browser.jQuery(elements) : elements;
       compileArgs = [elementsArgs];
       if (compiler.length !== 1) {
         dataList = u.map(elements, up.syntax.data);
@@ -4126,7 +4139,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
         element = e.closest(element, this.selector);
       }
       if (element) {
-        elementArg = this.jQuery ? jQuery(element) : element;
+        elementArg = this.jQuery ? up.browser.jQuery(element) : element;
         args = [event, elementArg];
         expectedArgCount = this.callback.length;
         if (!(expectedArgCount === 1 || expectedArgCount === 2)) {
@@ -4683,8 +4696,9 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
 
     FollowVariant.prototype.onClick = function(event, link) {
       if (up.link.shouldProcessEvent(event, link)) {
-        if (e.matches(link, '[up-instant]')) {
-          return up.event.halt(event);
+        if (e.matches(link, '[up-instant]') && link.upInstantSupported) {
+          up.event.halt(event);
+          link.upInstantSupported = false;
         } else {
           up.event.consumeAction(event);
           return this.followLink(link);
@@ -4696,6 +4710,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
 
     FollowVariant.prototype.onMousedown = function(event, link) {
       if (up.link.shouldProcessEvent(event, link)) {
+        link.upInstantSupported = true;
         up.event.consumeAction(event);
         return this.followLink(link);
       }
@@ -5347,18 +5362,19 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
       if (u.isMissing(raw)) {
 
       } else if (raw instanceof this.constructor) {
-        return (ref = this.entries).push.apply(ref, raw.entries);
+        (ref = this.entries).push.apply(ref, raw.entries);
       } else if (u.isArray(raw)) {
-        return (ref1 = this.entries).push.apply(ref1, raw);
+        (ref1 = this.entries).push.apply(ref1, raw);
       } else if (u.isString(raw)) {
-        return this.addAllFromQuery(raw);
+        this.addAllFromQuery(raw);
       } else if (u.isFormData(raw)) {
-        return this.addAllFromFormData(raw);
+        this.addAllFromFormData(raw);
       } else if (u.isObject(raw)) {
-        return this.addAllFromObject(raw);
+        this.addAllFromObject(raw);
       } else {
-        return up.fail("Unsupport params type: %o", raw);
+        up.fail("Unsupport params type: %o", raw);
       }
+      return this;
     };
 
     Params.prototype.addAllFromObject = function(object) {
@@ -6818,13 +6834,11 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
         });
         isBooting = false;
         return up.event.onReady(function() {
-          return u.task(function() {
-            up.emit('up:app:boot', {
-              log: 'Booting user application'
-            });
-            return up.emit('up:app:booted', {
-              log: 'User application booted'
-            });
+          up.emit('up:app:boot', {
+            log: 'Booting user application'
+          });
+          return up.emit('up:app:booted', {
+            log: 'User application booted'
           });
         });
       } else {
@@ -6951,7 +6965,7 @@ There are some advantages to using `up.on()`:
     for [event delegation](https://davidwalsh.name/event-delegate):
     
         var form = document.querySelector('form')
-        document.addEventListener(form, 'click', 'a', function(event, link) {
+        up.on(form, 'click', 'a', function(event, link) {
           console.log("Click on a link %o within %o", link, form)
         })
     
@@ -7263,14 +7277,22 @@ There are some advantages to using `up.on()`:
     };
 
     /***
-    Stops the given event from propagating and prevents the default action.
+    Prevents the event from bubbling up the DOM.
+    Also prevents other event handlers bound on the same element.
+    Also prevents the event's default action.
+    
+    \#\#\# Example
+    
+        up.on('click', 'link.disabled', function(event) {
+          up.event.halt(event)
+        })
     
     @function up.event.halt
-    @internal
+    @param {Event} event
+    @experimental
      */
     halt = function(event) {
       event.stopImmediatePropagation();
-      event.stopPropagation();
       return event.preventDefault();
     };
 
@@ -7579,7 +7601,7 @@ an existing cookie should be deleted.
       The parameter name can be configured as a string or as function that returns the parameter name.
       If no name is set, no token will be sent.
     
-      Defaults to the `content` attribute of a `<meta>` tag named `csrf-token`:
+      Defaults to the `content` attribute of a `<meta>` tag named `csrf-param`:
     
           <meta name="csrf-param" content="authenticity_token" />
     
@@ -7680,12 +7702,15 @@ The output can be configured using the [`up.log.config`](/up.log.config) propert
       prints to the developer console.
     @param {string} [options.prefix='[UP] ']
       A string to prepend to Unpoly's logging messages so you can distinguish it from your own messages.
+    @param {boolean} [options.banner=true]
+      Print the Unpoly banner to the developer console.
     @stable
      */
     config = new up.Config({
       prefix: '[UP] ',
       enabled: sessionStore.get('enabled'),
-      collapse: false
+      collapse: false,
+      banner: true
     });
     reset = function() {
       return config.reset();
@@ -7879,7 +7904,9 @@ The output can be configured using the [`up.log.config`](/up.log.config) propert
       }
       return console.log(banner);
     };
-    up.on('up:framework:booted', printBanner);
+    if (config.banner) {
+      up.on('up:framework:booted', printBanner);
+    }
     up.on('up:framework:reset', reset);
     setEnabled = function(value) {
       sessionStore.set('enabled', value);
@@ -8234,7 +8261,7 @@ 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 multiply Unpoly attributes.
+    Use `up.macro()` to register a compiler that sets multiple Unpoly attributes.
     
     \#\#\# Example
     
@@ -8413,15 +8440,14 @@ or when a matching fragment is [inserted via AJAX](/up.link) later.
       var cleanables;
       cleanables = e.subtree(fragment, '.up-can-clean');
       return u.each(cleanables, function(cleanable) {
-        var destructor, destructors, i, len, results;
-        if (destructors = cleanable.upDestructors) {
-          results = [];
+        var destructor, destructors, i, len;
+        if (destructors = u.pluckKey(cleanable, 'upDestructors')) {
           for (i = 0, len = destructors.length; i < len; i++) {
             destructor = destructors[i];
-            results.push(destructor());
+            destructor();
           }
-          return results;
         }
+        return cleanable.classList.remove('up-can-clean');
       });
     };
 
@@ -9380,13 +9406,37 @@ 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.
+    at the same URL, or by following a link with an [`[up-restore-scroll]`](/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
     
-    Unpoly automatically saves scroll positions whenever a fragment was updated on the page.
+    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
+          }
+        })
     
     @function up.viewport.saveScroll
     @param {string} [options.url]
+      The URL for which to save scroll positions.
+      If omitted, the current browser location is used.
     @param {Object<string, number>} [options.tops]
+      An object mapping viewport selectors to vertical scroll positions in pixels.
     @experimental
      */
     saveScroll = function(options) {
@@ -9767,7 +9817,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     
     \#\#\# Example
     
-    Let's say your curent HTML looks like this:
+    Let's say your current HTML looks like this:
     
         <div class="one">old one</div>
         <div class="two">old two</div>
@@ -10018,7 +10068,7 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     
     \#\#\# Example
     
-    Let's say your curent HTML looks like this:
+    Let's say your current HTML looks like this:
     
         <div class="one">old one</div>
         <div class="two">old two</div>
@@ -10568,7 +10618,11 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
         var parent;
         parent = element.parentNode;
         up.syntax.clean(element);
-        e.remove(element);
+        if (up.browser.canJQuery()) {
+          jQuery(element).remove();
+        } else {
+          e.remove(element);
+        }
         return emitFragmentDestroyed(element, {
           parent: parent,
           log: options.log
@@ -10593,7 +10647,8 @@ is built from `up.fragment` functions. You may use them to extend Unpoly from yo
     @stable
      */
     markElementAsDestroying = function(element) {
-      return element.classList.add('up-destroying');
+      element.classList.add('up-destroying');
+      return element.setAttribute('aria-hidden', 'true');
     };
 
     /***
@@ -10789,7 +10844,7 @@ You can define custom animations using [`up.transition()`](/up.transition) and
     
     You can pass additional options:
     
-        up.animate('warning', '.fade-in', {
+        up.animate('.warning', 'fade-in', {
           delay: 1000,
           duration: 250,
           easing: 'linear'
@@ -12107,7 +12162,7 @@ This makes for an unfriendly experience:
 - State changes caused by AJAX updates get lost during the page transition.
 - Unsaved form changes get lost during the page transition.
 - The JavaScript VM is reset during the page transition.
-- If the page layout is composed from multiple srollable containers
+- If the page layout is composed from multiple scrollable containers
   (e.g. a pane view), the scroll positions get lost during the page transition.
 - The user sees a "flash" as the browser loads and renders the new page,
   even if large portions of the old and new page are the same (navigation, layout, etc.).
@@ -12844,16 +12899,42 @@ open dialogs with sub-forms, etc. all without losing form state.
     @function up.form.fieldSelector
     @internal
      */
-    fieldSelector = function() {
-      return config.fields.join(',');
+    fieldSelector = function(suffix) {
+      if (suffix == null) {
+        suffix = '';
+      }
+      return config.fields.map(function(field) {
+        return field + suffix;
+      }).join(',');
     };
 
     /***
+    Returns a list of form fields within the given element.
+    
+    You can configure what Unpoly considers a form field by adding CSS selectors to the
+    [`up.form.config.fields`](/up.form.config#config.fields) array.
+    
+    If the given element is itself a form field, a list of that given element is returned.
+    
     @function up.form.fields
-    @internal
+    @param {Element|jQuery} root
+      The element to scan for contained form fields.
+    
+      If the element is itself a form field, a list of that element is returned.
+    @return {NodeList<Element>|Array<Element>}
+    @experimental
      */
     findFields = function(root) {
-      return e.subtree(root, fieldSelector());
+      var fields, outsideFieldSelector, outsideFields;
+      root = e.get(root);
+      fields = e.subtree(root, fieldSelector());
+      if (e.matches(root, 'form[id]')) {
+        outsideFieldSelector = fieldSelector(e.attributeSelector('form', root.id));
+        outsideFields = e.all(outsideFieldSelector);
+        fields.push.apply(fields, outsideFields);
+        fields = u.uniq(fields);
+      }
+      return fields;
     };
 
     /****
@@ -12980,6 +13061,9 @@ open dialogs with sub-forms, etc. all without losing form state.
       If set to `'auto'` (default), Unpoly will try to find a match in the form's layer.
     @param {string} [options.failLayer='auto']
       The name of the layer that ought to be updated if the server sends a non-200 status code.
+    @param {Object|FormData|string|Array|up.Params} [options.params]
+      Extra form [parameters](/up.Params) that will be submitted in addition to
+      the parameters from the form.
     @return {Promise}
       A promise for the successful form submission.
     @stable
@@ -13029,7 +13113,7 @@ open dialogs with sub-forms, etc. all without losing form state.
       if (options.failLayer == null) {
         options.failLayer = form.getAttribute('up-fail-layer');
       }
-      options.params = up.Params.fromForm(form);
+      options.params = up.Params.fromForm(form).addAll(options.params);
       options = u.merge(options, up.motion.animateOptions(options, form));
       if (options.validate) {
         options.headers || (options.headers = {});
@@ -13379,7 +13463,7 @@ open dialogs with sub-forms, etc. all without losing form state.
     
     \#\#\# Redirects
     
-    Unpoly requires an additional response headers to detect redirects,
+    Unpoly requires an additional response header to detect redirects,
     which are otherwise undetectable for an AJAX client.
     
     After the form's action performs a redirect, the next response should echo
@@ -13614,7 +13698,19 @@ open dialogs with sub-forms, etc. all without losing form state.
       This defaults to a fieldset or form group around the validating field.
     @stable
      */
-    up.on('change', '[up-validate]', function(event, field) {
+
+    /***
+    Performs [server-side validation](/input-up-validate) when any fieldset within this form changes.
+    
+    You can configure what Unpoly considers a fieldset by adding CSS selectors to the
+    [`up.form.config.validateTargets`](/up.form.config#config.validateTargets) array.
+    
+    @selector form[up-validate]
+    @stable
+     */
+    up.on('change', '[up-validate]', function(event) {
+      var field;
+      field = findFields(event.target)[0];
       return u.muteRejection(validate(field));
     });
 
@@ -13732,18 +13828,25 @@ open dialogs with sub-forms, etc. all without losing form state.
     
     The programmatic variant of this is the [`up.observe()`](/up.observe) function.
     
-    \#\#\# Examples
+    \#\#\# Example
     
     The following would run a global `showSuggestions(value)` function
     whenever the `<input>` changes:
     
-        <form>
-          <input name="query" up-observe="showSuggestions(value)">
-        </form>
+        <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:
+    The script given to `[up-observe]` runs with the following context:
     
     | Name     | Type      | Description                           |
     | -------- | --------- | ------------------------------------- |
@@ -13751,6 +13854,20 @@ open dialogs with sub-forms, etc. all without losing form state.
     | `this`   | `Element` | The form field                        |
     | `$field` | `jQuery`  | The form field as a jQuery collection |
     
+    \#\#\# Observing radio buttons
+    
+    Multiple radio buttons with the same `[name]` (a radio button group)
+    produce a single value for the form.
+    
+    To observe radio buttons group, use the `[up-observe]` attribute on an
+    element that contains all radio button elements with a given name:
+    
+        <div up-observe="formatSelected(value)">
+          <input type="radio" name="format" value="html"> HTML format
+          <input type="radio" name="format" value="pdf"> PDF format
+          <input type="radio" name="format" value="txt"> Text format
+        </div>
+    
     @selector input[up-observe]
     @param {string} up-observe
       The code to run when the field's value changes.
@@ -13799,7 +13916,7 @@ open dialogs with sub-forms, etc. all without losing form state.
     });
 
     /***
-    [Observes](/up.observe) this form field and submits the form when its value changes.
+    Submits this field's form when this field changes its values.
     
     Both the form and the changed field will be assigned a CSS class [`up-active`](/form-up-active)
     while the autosubmitted form is loading.
@@ -13815,6 +13932,20 @@ open dialogs with sub-forms, etc. all without losing form state.
           <input type="checkbox" name="archive"> Include archive
         </form>
     
+    \#\#\# Auto-submitting radio buttons
+    
+    Multiple radio buttons with the same `[name]` (a radio button group)
+    produce a single value for the form.
+    
+    To auto-submit radio buttons group, use the `[up-submit]` attribute on an
+    element that contains all radio button elements with a given name:
+    
+        <div up-autosubmit>
+          <input type="radio" name="format" value="html"> HTML format
+          <input type="radio" name="format" value="pdf"> PDF format
+          <input type="radio" name="format" value="txt"> Text format
+        </div>
+    
     @selector input[up-autosubmit]
     @param {string} up-delay
       The number of miliseconds to wait after a change before the form is submitted.
@@ -13822,7 +13953,7 @@ open dialogs with sub-forms, etc. all without losing form state.
      */
 
     /***
-    [Observes](/up.observe) this form and 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.
@@ -14698,6 +14829,7 @@ or function.
       var closeElement, contentElement, dialogStyles, html, modalElement;
       html = templateHtml();
       state.modalElement = modalElement = e.createFromHtml(html);
+      modalElement.setAttribute('aria-modal', 'true');
       modalElement.setAttribute('up-flavor', state.flavor);
       if (u.isPresent(state.position)) {
         modalElement.setAttribute('up-position', state.position);
@@ -14736,7 +14868,7 @@ or function.
         var link = document.querySelector('a')
         up.modal.follow(link)
     
-    Any option attributes for [`a[up-modal]`](/a.up-modal) will be honored.
+    Any option attributes for [`a[up-modal]`](/a-up-modal) will be honored.
     
     Emits events [`up:modal:open`](/up:modal:open) and [`up:modal:opened`](/up:modal:opened).
     
@@ -14919,6 +15051,9 @@ or function.
       if (options.failLayer == null) {
         options.failLayer = (ref12 = link.getAttribute('up-fail-layer')) != null ? ref12 : 'auto';
       }
+      if (options.cache == null) {
+        options.cache = e.booleanAttr(link, 'up-cache');
+      }
       animateOptions = up.motion.animateOptions(options, link, {
         duration: flavorDefault('openDuration', options.flavor),
         easing: flavorDefault('openEasing', options.flavor)
@@ -15175,7 +15310,7 @@ or function.
     
     Clicking would request the path `/blog` and select `.blog-list` from
     the HTML response. Unpoly will dim the page
-    and place the matching `.blog-list` tag will be placed in
+    and place the matching `.blog-list` tag in
     a modal dialog.
     
     @selector a[up-modal]