unpoly-rails 0.62.0 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 550a7dc0636e2a9775132e49cdd0dd0def39be7772c24f0b58f361045753d30a
-  data.tar.gz: 90450c13bc60983f7763a85415ff9f45b3fc6ef500874a0b7c9e8934096abb12
+  metadata.gz: 91eeb3a0e727e868391bd42e37a86e7ed8cc1c7f9644a09b22e0a653d36b2ceb
+  data.tar.gz: a0e38887ff10a26a461311a4f73cb6e7d17ddac40fffb0a7e44e77a674a73c8f
 SHA512:
-  metadata.gz: f66c2c21e85749d2fe2f2f9e6c265b0278aea11e6d49c2e45d46165776ad18c952ac3ab5065f680a00c6c41f91e8dd4a4c9efb6be867da428f6910316d42fb5d
-  data.tar.gz: aa3f05e3eb78629f8ce81d438fc1f5e5ee9714bcba51fae49dfe7751b286f2b78592cfd81b96a17cd574491ef83e62d193d9c8be56647d0a8afb1be1f78cf4c1
+  metadata.gz: c00b889747a5cd70a5c93e6a31478dc609aad7046c9ce4334724f6b39ef398678246936b8152c0a08d1284976a736521ce5f994959b19d66f384f0625f349c40
+  data.tar.gz: a65dda307897f584bee082d909ddfcbc5fc606487ead7916a298d7d10445e83f5c60bc63a60bed896ef26c6c57d5c2c52038eca271bf0bac6d23fc7c2aa2fc64

data/CHANGELOG.md

@@ -6,6 +6,53 @@ 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.3
+-----
+
+This maintenance release addresses two issues that were introduced in version 1.0.0:
+
+- Unpoly can now be loaded with `<script defer>`. This can be used to load your scripts without blocking the DOM parser.
+- Unpoly can now be loaded with `<script type="module">`. This can be used deliver a modern JS build to modern browsers only.
+
+
+1.0.1
+-----
+
+This is a maintenance release for Unpoly 1. Expect little to no additional changes for this legacy version. New features will only be added to Unpoly 2.
+
+- `up.request()` will now send Unpoly's version number as an `X-Up-Version` request header. Since `X-Up-Target` is optional in Unpoly 2, server-side integration libraries can look for `X-Up-Version` to reliably detect a fragment update for both Unpoly 1 and 2.
+- Fix a bug where the Unpoly banner would still be printed to the development console when `up.log.config.banner = false` is set. (fix by @adam12)
+
+
+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
 ------
 

data/Gemfile

@@ -1,7 +1,6 @@
 source 'https://rubygems.org'
 
 gem 'rack'
-gem 'therubyracer'
 gem 'sass'
 gem 'uglifier'
 gem 'coffee-script'

data/Gemfile.lock

@@ -8,11 +8,9 @@ GEM
     execjs (2.7.0)
     hike (1.2.3)
     json (1.8.2)
-    libv8 (3.16.14.11)
     multi_json (1.10.1)
     rack (1.6.0)
     rake (10.4.2)
-    ref (1.0.5)
     sass (3.4.11)
     sprockets (2.12.3)
       hike (~> 1.2)
@@ -22,9 +20,6 @@ GEM
     sprockets-standalone (1.2.1)
       rake
       sprockets (~> 2.0)
-    therubyracer (0.12.1)
-      libv8 (~> 3.16.14.0)
-      ref
     tilt (1.4.1)
     uglifier (2.7.0)
       execjs (>= 0.3.0)
@@ -38,8 +33,7 @@ DEPENDENCIES
   rack
   sass
   sprockets-standalone
-  therubyracer
   uglifier
 
 BUNDLED WITH
-   1.16.1
+   1.17.3

data/README.md

@@ -31,8 +31,9 @@ Overview:
 
 Install dependencies for tests:
 
-- Install Ruby 2.1.2
+- 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 +51,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 the following 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.
@@ -64,6 +63,7 @@ To prepare a new version:
 1. Edit `lib/unpoly/rails/version.rb` and bump the version number. Use [semantic versioning](http://semver.org/).
 2. Add an entry to `CHANGELOG.md`
 3. Commit and push the version bump and `CHANGELOG.md`
+4. Merge the relevant `CHANGEOG.md` entries to the `master` branch (since [unpoly.com](https://unpoly.com) builds from there)
 
 Now we can release a new version. **This requires your to be logged into Rubygems and npm**:
 
@@ -78,8 +78,9 @@ If you have done this process a few times and know what you're doing, you can ca
 
 After you have published all release channels, remember to:
 
-1. Update [unpoly.com](https://unpoly.com/) so users see the new version, CDN link and CHANGELOG.
-2. Send a message to the [E-mail group](https://groups.google.com/group/unpoly) with the title "Unpoly X.Y.Z released". You can copy the relevant CHANGELOG part from [here](http://localhost:4567/changes_google_groups).
+1. Deploy to [unpoly.com](https://unpoly.com/)
+2. Deploy to [v1.unpoly.com](https://unpoly.com/)
+3. Send a message to the [E-mail group](https://groups.google.com/group/unpoly) with the title "Unpoly X.Y.Z released". You can copy the relevant CHANGELOG part from [here](http://localhost:4567/changes_google_groups).
 
 
 Credits

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
 
@@ -117,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
@@ -132,7 +141,7 @@ namespace :npm do
   end
 
   task :publish do
-    system('npm publish') or raise 'Could not publish npm module'
+    system('npm publish --tag 1.x-stable') or raise 'Could not publish npm module'
   end
 
 end

data/dist/unpoly.js

@@ -5,7 +5,7 @@
 
 (function() {
   window.up = {
-    version: "0.62.0"
+    version: "1.0.3"
   };
 
 }).call(this);
@@ -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];
       });
     };
@@ -2519,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) {
@@ -2557,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
      */
@@ -3428,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() {
@@ -5358,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) {
@@ -5967,6 +5972,7 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
             xhrPayload = xhrParams.toFormData();
           }
           pc = up.protocol.config;
+          xhrHeaders[pc.versionHeader] = up.version;
           if (_this.target) {
             xhrHeaders[pc.targetHeader] = _this.target;
           }
@@ -6828,14 +6834,12 @@ It complements [native `Element` methods](https://www.w3schools.com/jsref/dom_ob
           log: 'Framework booted'
         });
         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'
-            });
+        return document.addEventListener('DOMContentLoaded', function() {
+          up.emit('up:app:boot', {
+            log: 'Booting user application'
+          });
+          return up.emit('up:app:booted', {
+            log: 'User application booted'
           });
         });
       } else {
@@ -7574,6 +7578,7 @@ an existing cookie should be deleted.
     Configures strings used in the optional [server protocol](/up.protocol).
     
     @property up.protocol.config
+    @param {String} [config.versionHeader='X-Up-Version']
     @param {String} [config.targetHeader='X-Up-Target']
     @param {String} [config.failTargetHeader='X-Up-Fail-Target']
     @param {String} [config.locationHeader='X-Up-Location']
@@ -7617,6 +7622,7 @@ an existing cookie should be deleted.
     @experimental
      */
     config = new up.Config({
+      versionHeader: 'X-Up-Version',
       targetHeader: 'X-Up-Target',
       failTargetHeader: 'X-Up-Fail-Target',
       locationHeader: 'X-Up-Location',
@@ -7699,12 +7705,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();
@@ -7890,6 +7899,9 @@ The output can be configured using the [`up.log.config`](/up.log.config) propert
     };
     printBanner = function() {
       var banner;
+      if (!config.banner) {
+        return;
+      }
       banner = " __ _____  ___  ___  / /_ __\n" + ("/ // / _ \\/ _ \\/ _ \\/ / // /  " + up.version + "\n") + "\\___/_//_/ .__/\\___/_/\\_. / \n" + "        / /            / /\n" + "\n";
       if (config.enabled) {
         banner += "Call `up.log.disable()` to disable logging for this session.";
@@ -7898,7 +7910,7 @@ The output can be configured using the [`up.log.config`](/up.log.config) propert
       }
       return console.log(banner);
     };
-    up.on('up:framework:booted', printBanner);
+    up.on('up:app:boot', printBanner);
     up.on('up:framework:reset', reset);
     setEnabled = function(value) {
       sessionStore.set('enabled', value);
@@ -8432,15 +8444,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');
       });
     };
 
@@ -10837,7 +10848,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'
@@ -13054,6 +13065,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
@@ -13103,7 +13117,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 = {});
@@ -13825,6 +13839,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:
@@ -15032,6 +15055,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)