unpoly-rails 0.37.0 → 0.50.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 12f680d0e152470791793c144a1cbd2dcd6bd336
-  data.tar.gz: 21808898aa425e35c06c63fbdad3abbce3b7b3c8
+  metadata.gz: ccf4b7d6145f93121c5acc9652dfef805bf053f7
+  data.tar.gz: 3fc6c14aea9fd2544948fea9603efd80aa391c23
 SHA512:
-  metadata.gz: eff3e86b52040276213bad2591b68a7699c755ccac7093e70c33ae743608507ce4417a24c12e4f2975b507a1a6ceda546a2d6ae31effcf99cbc883f5da2c67ae
-  data.tar.gz: 05780d9786d8cf18c979b4e3b51fde5779631a7c91d2a7afa0f190651c790c72db660c31a9b2f52add0834728cc08982eca77051aa96f0dea059be5f9c1f51d7
+  metadata.gz: 14b9d6ebf35fc320a90a168f3975c158983eb0ffa8044b28e94f2d230da0197c071854dffb1de59002e570d27115fa7262e0b993621ade657b7042344fb17b28
+  data.tar.gz: b68eff54dc035c0fce2ca479b43ce5c5b89db06de7e9b52e83a16a9eb95399698e09ea77a0d6c1980a3499eab67f71580e97997379a51d79e50c3837b6e6e0c2

data/CHANGELOG.md

@@ -6,6 +6,106 @@ Changes to this project will be documented in this file.
 This project mostly adheres to [Semantic Versioning](http://semver.org/).
 
 
+0.50.0
+------
+
+This is a major update with some breaking changes. Expect a few more updates like this as we move closer to our 1.0 release in 2018.
+
+### General
+
+- jQuery 3 is now supported in addition to jQuery 1.9+ and jQuery 2.
+- Unpoly now uses [native Promises](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Using_promises) instead of jQuery deferreds.
+- You can now help improve Unpoly's documentation by clicking an *Edit this page* link on any [unpoly.com](https://unpoly.com/) subpage (like [`a[up-target]`](/a-up-target)).
+
+### Browser support
+
+- To enable support for Internet Explorer 11 you need to install a Polyfill for `Promise`. We recommend [ES6-promise](https://github.com/stefanpenner/es6-promise) (2.4 KB gzipped).
+- Fix a bug where Unpoly would not boot on Safari 9 and 10 if the initial page was loaded with a `POST` method.
+
+### AJAX
+
+- Unpoly now uses [native XMLHttpRequest](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest) instead of `jQuery.ajax()`. If you have been hacking into Unpoly's networking through `jQuery.ajaxPrefilter()`, you must now use the [`up:proxy:load`](/up:proxy:load) event.
+- [`up.ajax()`](/up.ajax) has been deprecated since its signature is incompatible with native promises. Please use [`up.request()`](/up.request) instead, whose promise fulfills with an [`up.Response`](/up.Response) object.
+- The `up:proxy:received` event has been renamed to [`up:proxy:loaded`](/up:proxy:loaded).
+- The [`up:proxy:load`](/up:proxy:load) event properties have changed. You can now access request properties through a key `{ request }`, e.g. `event.request.url`.
+- The [`up:proxy:load`](/up:proxy:load) event can now be prevented to prevent a request from being sent to the network.
+-  The [`up:proxy:load`](/up:proxy:load) event now allows listeners to change request headers by manipulating the `event.request.headers` object.
+- A new event [`up:proxy:fatal`](/up:proxy:fatal) will be [emitted](/up.emit) when an [AJAX request](/up.request) encounters fatal error like a timeout or loss of network connectivity.
+
+### Links
+
+- Links with unsafe HTTP methods like `POST` are no longer marked as [`.up-current`](/a.up-current), even if their `[href]` matches the current URL.
+- New experimental function [`up.link.isSafe()`](/up.link.isSafe). It returns whether the given link has a [safe](https://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9.1.1) HTTP method like `GET`.
+
+### Fragment updates
+
+- When a selector was not found in the response, the error notification now offers a link to show the unexpected response.
+- The event [`up:fragment:destroy`](/up:fragment:destroy) can no longer be prevented.
+
+### History
+
+- Clicking a link with an [`[up-restore-scroll]`](/a-up-target#up-restore-scroll) attribute will no longer crash if no previous scroll position for given URL is known ([#25](https://github.com/unpoly/unpoly/issues/25))
+- Fix a bug where going back in history would sometimes not call destructors ([#24](https://github.com/unpoly/unpoly/issues/24))
+
+### Forms
+
+- [`up.observe()`](/up.observe) no longer sends multiple callbacks when a previous callback was slow to respond.
+
+### Tooltips
+
+- Fix a bug where tooltips would sometimes stay open when many tooltips are opened and closed concurrently.
+
+### Server protocol
+
+- When the server [signals a redirect with a `X-Up-Location` header](/up.protocol#redirect-detection), sending a `X-Up-Method` header is now optional. If it is missing, `GET` is assumed.
+- Unpoly will often update a different selector in case the request fails. This second selector is now sent to the server as a `X-Up-Fail-Target` header.
+- You can now [configure how CSRF tokens are sent your server-side framework](/up.protocol.config).
+- CSRF tokens are no longer sent for cross-domain requests.
+
+### Animation
+
+- `up.motion.none()` has been removed without replacement. Just pass `false` or the string `'none'` to indicate a animation or transition which has no visual effects and completes instantly.
+- [`up.motion.finish()`](/up.motion.finish) is now async. It returns a promise that fulfills when all animations are finished.
+- [`up.motion.finish()`](/up.motion.finish) now also finishes animations in ancestors of the given element.
+
+### Modals
+
+- [`up.follow()`](/up.follow) will now open a modal if the given link has an [`[up-modal]`](/a-up-modal) attribute
+- [`a[up-modal]`](/a-up-modal) links can now have an `[up-fail-target]` attribute to indicate which selector to replace for an non-200 response
+- Fix a bug where preloading an up-modal link would create an invisible .up-modal container in the DOM.
+
+### Popups
+
+- [`up.follow()`](/up.follow) will now open a popup if the given link has [`[up-popup]`](/a-up-popup) attribute
+- up-popup links can now have an up-fail-target attribute to indicate which selector to replace for an non-200 response
+- Fix a bug where preloading an up-popup link would create an invisible .up-popup container in the DOM.
+- [`up.popup.attach()`](/up.popup.attach) now throws an error if neither `{ url }` nor `{ html }` options are given.
+
+### Events
+
+- When async functions emit an event and that event is prevented, the async function now rejects with an [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error).
+- When async functions are called wth `{ confirm: true }` and the user denies confirmation, the async function now rejects with an [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error).
+
+### Utility functions
+
+- [`up.util.setTimer()`](/up.util.setTimer) is now always async, even when called with a delay of `0` (zero). The function is now stable.
+- `up.util.isHash()` has been removed without replacement. In your code you can replace `up.util.isHash(x)` with `up.util.isObject(x) && !up.util.isFunction(x)`.
+- `up.util.resolvedDeferred()` has been removed without replacement. Use `Promise.resolve()` instead.
+- `up.util.resolvedPromise()` has been removed without replacement. Use `Promise.resolve(`) instead.
+- `up.util.rejectedPromise()` has been removed without replacement. Use `Promise.reject()` instead.
+- `up.util.unresolvableDeferred()` has been removed without replacement. Use `new Promise(function() {})` instead.
+- `up.motion.when()` has been removed without replacement. Use `Promise.all()` instead.
+- [`up.util.isString()`](/up.util.isString) now also returns true for `String` instances (in addition to string literals)
+- [`up.util.isNumber()`](/up.util.isNumber()) now also returns true for `Number` instances (in addition to number literals)
+
+### Ruby on Rails bindings
+
+- New method `up.fail_target` available in controllers, helpers and views. It returns the selector targeted for a failed response.
+- New method `up.fail_target?(target)` available in controllers, helpers and views. It returns whether the given selector is targeted for a failed response.
+- New method `up.any_target?(target)` available in controllers, helpers and views. It returns whether the given selector is targeted for a either a successful or failed response.
+
+
+
 0.37.0
 ------
 
@@ -15,7 +115,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 - Fix a bug where [`[up-layer]`](/up-layer) attributes or `{ layer }` options were ignored.
 - [`a[up-target]`](/a-up-target) and [`form[up-target]`] get a new modifying attribute `[up-fail-layer]`.
   Use it to set the layer to update if the server sends a non-200 status code. Valid values are `auto`, `page`, `modal` and `popup`.
-- JavaScript functions like [`up.replace()`](/up.replace) or [`up.submit()`](/up.submit) now have a `{ failLayer }` option. 
+- JavaScript functions like [`up.replace()`](/up.replace) or [`up.submit()`](/up.submit) now have a `{ failLayer }` option.
 
 
 0.36.2
@@ -23,7 +123,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 
 ### Compatible changes
 
-- [Validating forms](https://unpoly.com/up-validate) will no longer change the scroll position.
+- [Validating forms](https://unpoly.com/input-up-validate) will no longer change the scroll position.
 
 
 0.36.1
@@ -33,7 +133,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 
 - [npm package](/install/npm) now expresses Unpoly's dependency on `jquery`.
 - [Modals](/up.modal) no longer close when clicking an element that exists outside the modal's DOM hierarchy.
-- Fix a bug on IE11 where modals would immediately close after opening if the opening link had an [`[up-instant]`](/up-instant) attribute and the destination page was already cached.
+- Fix a bug on IE11 where modals would immediately close after opening if the opening link had an [`[up-instant]`](/a-up-instant) attribute and the destination page was already cached.
 
 
 0.36.0
@@ -43,7 +143,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 
 - The [`[up-observe]`](/up-observe) attribute can now be set on a `<form>` to run a function if any
   contained input field changes.
-- Fix a bug where [`[up-autosubmit]`](/up-autosubmit) didn't honor an `[up-delay]` attribute if
+- Fix a bug where [`[up-autosubmit]`](/form-up-autosubmit) didn't honor an `[up-delay]` attribute if
   used on a form.
 - When [submitting a form](/form-up-target), the `name` and `value` of the submit button is now included with the form parameters.
 - [Going back in history](/up.history) after a [fragment update](/up.link) now always restores elements the page layer, never a selector in [modals](/up.modal) or [popups](/up.popup).
@@ -100,7 +200,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 ### Compatible changes
 
 - Elements with [`up-show-for`](/up-show-for) and [`up-hide-for`](/up-hide-for) attributes
-  can now be inserted dynamically after its controlling [`up-switch`](/up-switch) field has been
+  can now be inserted dynamically after its controlling [`up-switch`](/input-up-switch) field has been
   compiled.
 - Unpoly no longer strips a trailing slash in the current URL during startup
 
@@ -180,7 +280,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 - Fix a bug where [`up.reveal()`](/up.reveal) would not scroll to an element at the bottom edge of the visible area
   if [`up.layout.config.snap`](/up.layout.config) is set.
 - Several features have been promoted from experimental API to stable API:
-  - [`[up-drawer]`](/up-drawer)
+  - [`[up-drawer]`](/a-up-drawer)
   - [`up.syntax.data()`](/up.syntax.data)
   - [`up.extract()`](/up.extract)
 - When [targeting](/up-target) an URL with a #hash, the viewport will now scroll to the first row of an element
@@ -210,7 +310,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 
 ### Compatible changes
 
-- Drawers are now a built-in modal flavor! Use the [`[up-drawer]`](/up-drawer) attribute to open page fragements
+- Drawers are now a built-in modal flavor! Use the [`[up-drawer]`](/a-up-drawer) attribute to open page fragements
   in a modal drawer that slides in from the edge of the screen.
 
 
@@ -330,7 +430,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 
 - Fix a bug where absolutely positioned elements would be offset incorrectly during transitions
 - Fix a bug where inserted elements were not revealed within their viewport
-- When [validating](/up-validate) a form with transitions, transitions are no longer applied
+- When [validating](/input-up-validate) a form with transitions, transitions are no longer applied
 
 
 ### Breaking changes
@@ -367,7 +467,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 
 - Tooltips now open and close much quicker.
 - Popups now open and close much quicker.
-- [`.up-current`](/up-current) now considers two URLs different if they have different query strings.
+- [`.up-current`](/a.up-current) now considers two URLs different if they have different query strings.
 
 
 
@@ -378,7 +478,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 
 - Popups anchored to fixed elements are now positioned correctly if the document is scrolled
 - Tooltips can now be anchored to fixed elements
-- [`up-modal`](/up-modal) and [`up-popup`](/up-popup) now support an `up-method` modifier.
+- [`up-modal`](/a-up-modal) and [`up-popup`](/a-up-popup) now support an `up-method` modifier.
 
 
 
@@ -457,7 +557,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 - When opening a modal while another modal is open, the first modal will be closed (with animation) before the second modal opens (with animation)
 - When opening a popup while another popup is open, the first popup will be closed (with animation) before the second popup opens (with animation)
 - User-defined macros are now always run *before* built-in macros.
-  This way you can set [`[up-dash]`](/up-dash) and [`[up-expand]`](/up-expand) from your own macros.
+  This way you can set [`a[up-dash]`](/a-up-dash) and [`[up-expand]`](/up-expand) from your own macros.
 
 
 0.24.1
@@ -488,7 +588,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 - Calling [`up.motion.finish()`](/up.motion.finish) without arguments will now
   complete all animations and transitions on the screen.
 - Fix a bug where [`up.motion.finish()`](/up.motion.finish) would not cancel CSS transitions that were still in progress.
-- Fix a bug where [`up-active`](/up-active) classes where not removed from links when the destination
+- Fix a bug where [`up-active`](/a.up-active) classes where not removed from links when the destination
   was already [preloaded](/up.preload).
 
 
@@ -531,8 +631,8 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 - Fix [`up.util.trim()`](/up.util.trim) not working properly.
 - [`up.morph()`](/up.morph) no longer throws an error if called without an `options` object
 - Custom transitions can now call [`up.morph()`](/up.morph) to refer to other transitions
-- Fix a bug where following a link to a [preloaded](/up-preload) destination would keep the
-  link marked with a [up-active](/up-active) class forever.
+- Fix a bug where following a link to a [preloaded](/a-up-preload) destination would keep the
+  link marked with a [up-active](/a.up-active) class forever.
 
 
 0.23.0
@@ -558,10 +658,10 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 - Fix a bug where the document title wasn't restored when using the back
   and forward buttons
 - Fix a bug where links would be followed multiple times if the link
-  had an [`up-dash`](/up-dash) attribute without a value and also an `up-target` attribute.
+  had an [`up-dash`](/a-up-dash) attribute without a value and also an `up-target` attribute.
 - Fix a bug where a link would be followed multiple times if the link's
   click area was expanded using [`[up-expand]`](/up-expand) and if the
-  link also had an [`up-dash`](/up-dash) attribute.
+  link also had an [`up-dash`](/a-up-dash) attribute.
 - [`up.destroy()`](/up.destroy) now returns a resolved deferred if the given selector or jQuery collection does not exist
 
 
@@ -571,8 +671,8 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 ### Compatible changes
 
 - Fix a bug where using the `up-confirm` attribute would result in an infinite loop
-- Unpoly no longer displays confirmation dialogs when [preloading](/up-preload) a link that
-  has both [`up-preload`](/up-preload) and `up-confirm` attributes.
+- Unpoly no longer displays confirmation dialogs when [preloading](/a-up-preload) a link that
+  has both [`up-preload`](/a-up-preload) and `up-confirm` attributes.
 
 
 ### Breaking changes
@@ -651,9 +751,9 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 - New function [`up.off()`](/up.off). This unregisters an event listener previously bound with [`up.on()`](/up.on).
 - If a container contains more than one link, you can now set the value of the [`up-expand`](/up-expand)
   attribute to a CSS selector to define which link should be expanded.
-- You can now configure a list of idempotent HTTP methods in [`up.proxy.config.safeMethods`](/up.proxy.config).
-  The proxy cache will only cache idempotent requests and will clear the entire
-  cache after a non-idempotent request.
+- You can now configure a list of safe HTTP methods in [`up.proxy.config.safeMethods`](/up.proxy.config).
+  The proxy cache will only cache safe requests and will clear the entire
+  cache after a unsafe request.
 - Loading modals and popups will now open if there is a fragment update between the modal/popup's
   request and response.
 - [`up.follow()`](/up.follow) and [`up.replace()`](/up.replace) now have an option `{ failTarget }`.
@@ -664,6 +764,8 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 - New utility method [`up.util.only()`](/up.util.only)
 - New utility method [`up.util.except()`](/up.util.except)
 - Fix a bug where modals could no longer be opened on some browsers
+- When preventing an event emitted by an async function, that function now rejects its promise.
+- Async functions that encounter an error now prefer to reject promises with an [`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) object (instead of a string with the error message)
 
 ### Breaking changes
 
@@ -688,7 +790,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 
 - When used with the [Ruby on Rails unobtrusive scripting adapter](https://github.com/rails/jquery-ujs) (`rails_ujs.js`),
   now prevents duplicate form submission when Unpoly attributes are mixed with `data-method` attributes.
-- [`[up-instant]`](/up-instant) now works with modals and popups
+- [`a[up-instant]`](/a-up-instant) now works with modals and popups
 - [`[up-expand]`](/up-expand) now works with modals and popups
 
 ### Breaking changes
@@ -739,7 +841,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 
 ### Compatible changes
 
-- New function [`up.autosubmit()`](/up.autosubmit) and selector [`[up-autosubmit]`](/up-autosubmit) to
+- New function [`up.autosubmit()`](/up.autosubmit) and selector [`[up-autosubmit]`](/form-up-autosubmit) to
   observe a form or field and submit the form when a value changes.
 - [`up.observe()`](/up.observe) and [`[up-observe]`](/up-observe) can now be applied
   to `<form>` tags. The callback is run when any field in the form changes.
@@ -777,7 +879,7 @@ This project mostly adheres to [Semantic Versioning](http://semver.org/).
 ### Compatible changes
 
 - Support for server-side live validation of forms
-  using the [`[up-validate]`](/up-validate) selector.
+  using the [`[up-validate]`](/input-up-validate) selector.
 - Support for [non-standard CSS selectors from jQuery](https://api.jquery.com/category/selectors/),
   such as [`:has`](http://api.jquery.com/has-selector/) or [`:visible`](http://api.jquery.com/visible-selector/).
 - Allow to refer to the current element as `&` in target selectors. This is useful
@@ -991,7 +1093,7 @@ Refactored internals. No API changes.
 ### Compatible changes
 
 - Viewport scroll positions are saved when the URL changes and restored when the user hits the back/forward button
-- Allow to link to the previous page using [`[up-back]`](/up-back)
+- Allow to link to the previous page using [`[up-back]`](/a-up-back)
 - Allow to restore previous scroll state using [`[up-restore-scroll]`](/a-up-target)
 - Instead of saying `<tag up-something="true">` you can now simply say `<tag up-something>`.
 - Create this Changelog.

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2014-2015 Henning Koch
+Copyright (c) 2014-2017 Henning Koch
 
 MIT License
 

data/README_RAILS.md

@@ -38,7 +38,7 @@ This is useful when you skip rendering the `<head>` in an Unpoly request.
 
 ### Detecting an Unpoly form validation
 
-To test whether the current request is a [form validation](https://unpoly.com/up-validate):
+To test whether the current request is a [form validation](https://unpoly.com/input-up-validate):
 
     up.validate?
 
@@ -84,7 +84,9 @@ What you still need to do manually
 
 Unpoly lets you submit forms via AJAX by using the [`form[up-target]`](https://unpoly.com/form-up-target) selector or [`up.submit()`](https://unpoly.com/up.submit) function.
 
-For Unpoly to be able to detect a failed form submission, the form must be re-rendered with a non-200 HTTP status code. We recommend to use either 400 (bad request) or 422 (unprocessable entity).
+For Unpoly to be able to detect a failed form submission,
+the form must be re-rendered with a non-200 HTTP status code.
+We recommend to use either 400 (bad request) or 422 (unprocessable entity).
 
 To do so in Rails, pass a [`:status` option to `render`](http://guides.rubyonrails.org/layouts_and_rendering.html#the-status-option):
 

data/Rakefile

@@ -7,7 +7,12 @@ require 'json'
 
 module Unpoly
   module Tasks
-    SPROCKETS_MANIFESTS = %w(unpoly.js unpoly-bootstrap3.js unpoly.css unpoly-bootstrap3.css)
+    SPROCKETS_MANIFESTS = %w(
+      unpoly.js
+      unpoly.css
+      unpoly-bootstrap3.js
+      unpoly-bootstrap3.css
+    )
     SPROCKETS_SOURCES = %w(lib/assets/javascripts lib/assets/stylesheets)
     SPROCKETS_OUTPUT_FOLDER = 'dist'
     NPM_MANIFEST = 'package.json'