RubyGems - unpoly-rails - Versions diffs - 0.56.7 → 0.57.0 - Mend

unpoly-rails 0.56.7 → 0.57.0

Potentially problematic release.

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

Files changed (67) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +74 -1
data/dist/unpoly.js +1569 -793
data/dist/unpoly.min.js +4 -4
data/lib/assets/javascripts/unpoly.coffee +2 -0
data/lib/assets/javascripts/unpoly/browser.coffee.erb +25 -41
data/lib/assets/javascripts/unpoly/bus.coffee.erb +20 -6
data/lib/assets/javascripts/unpoly/classes/cache.coffee +23 -13
data/lib/assets/javascripts/unpoly/classes/compile_pass.coffee +87 -0
data/lib/assets/javascripts/unpoly/classes/focus_tracker.coffee +29 -0
data/lib/assets/javascripts/unpoly/classes/follow_variant.coffee +7 -4
data/lib/assets/javascripts/unpoly/classes/record.coffee +1 -1
data/lib/assets/javascripts/unpoly/classes/request.coffee +38 -45
data/lib/assets/javascripts/unpoly/classes/response.coffee +16 -1
data/lib/assets/javascripts/unpoly/classes/store/memory.coffee +26 -0
data/lib/assets/javascripts/unpoly/classes/store/session.coffee +59 -0
data/lib/assets/javascripts/unpoly/cookie.coffee +56 -0
data/lib/assets/javascripts/unpoly/dom.coffee.erb +67 -39
data/lib/assets/javascripts/unpoly/feedback.coffee +2 -2
data/lib/assets/javascripts/unpoly/form.coffee.erb +23 -12
data/lib/assets/javascripts/unpoly/history.coffee +2 -2
data/lib/assets/javascripts/unpoly/layout.coffee.erb +118 -99
data/lib/assets/javascripts/unpoly/link.coffee.erb +12 -5
data/lib/assets/javascripts/unpoly/log.coffee +6 -5
data/lib/assets/javascripts/unpoly/modal.coffee.erb +9 -2
data/lib/assets/javascripts/unpoly/motion.coffee.erb +2 -6
data/lib/assets/javascripts/unpoly/namespace.coffee.erb +2 -2
data/lib/assets/javascripts/unpoly/params.coffee.erb +522 -0
data/lib/assets/javascripts/unpoly/popup.coffee.erb +3 -3
data/lib/assets/javascripts/unpoly/proxy.coffee +42 -34
data/lib/assets/javascripts/unpoly/{syntax.coffee → syntax.coffee.erb} +59 -117
data/lib/assets/javascripts/unpoly/{util.coffee → util.coffee.erb} +206 -171
data/lib/unpoly/rails/version.rb +1 -1
data/package.json +1 -1
data/spec_app/Gemfile.lock +1 -1
data/spec_app/app/assets/javascripts/integration_test.coffee +0 -4
data/spec_app/app/assets/stylesheets/integration_test.sass +7 -1
data/spec_app/app/controllers/pages_controller.rb +4 -0
data/spec_app/app/views/form_test/basics/new.erb +34 -5
data/spec_app/app/views/form_test/submission_result.erb +2 -2
data/spec_app/app/views/form_test/uploads/new.erb +15 -2
data/spec_app/app/views/hash_test/unpoly.erb +30 -0
data/spec_app/app/views/pages/start.erb +2 -1
data/spec_app/spec/javascripts/helpers/parse_form_data.js.coffee +17 -2
data/spec_app/spec/javascripts/helpers/reset_up.js.coffee +5 -0
data/spec_app/spec/javascripts/helpers/to_be_error.coffee +1 -1
data/spec_app/spec/javascripts/helpers/to_match_selector.coffee +5 -0
data/spec_app/spec/javascripts/up/browser_spec.js.coffee +8 -8
data/spec_app/spec/javascripts/up/bus_spec.js.coffee +58 -20
data/spec_app/spec/javascripts/up/classes/cache_spec.js.coffee +78 -0
data/spec_app/spec/javascripts/up/classes/focus_tracker_spec.coffee +31 -0
data/spec_app/spec/javascripts/up/classes/request_spec.coffee +50 -0
data/spec_app/spec/javascripts/up/classes/store/memory_spec.js.coffee +67 -0
data/spec_app/spec/javascripts/up/classes/store/session_spec.js.coffee +113 -0
data/spec_app/spec/javascripts/up/dom_spec.js.coffee +133 -45
data/spec_app/spec/javascripts/up/form_spec.js.coffee +13 -13
data/spec_app/spec/javascripts/up/layout_spec.js.coffee +110 -26
data/spec_app/spec/javascripts/up/link_spec.js.coffee +1 -1
data/spec_app/spec/javascripts/up/modal_spec.js.coffee +1 -0
data/spec_app/spec/javascripts/up/motion_spec.js.coffee +52 -51
data/spec_app/spec/javascripts/up/namespace_spec.js.coffee +2 -2
data/spec_app/spec/javascripts/up/params_spec.coffee +768 -0
data/spec_app/spec/javascripts/up/proxy_spec.js.coffee +75 -36
data/spec_app/spec/javascripts/up/syntax_spec.js.coffee +48 -15
data/spec_app/spec/javascripts/up/util_spec.js.coffee +148 -131
metadata +17 -5
data/spec_app/spec/javascripts/up/classes/.keep +0 -0

data/lib/assets/javascripts/unpoly/link.coffee.erb CHANGED

@@ -122,8 +122,13 @@ up.link = (($) ->
     An element or selector which is either an `<a>` tag or any element with an `up-href` attribute.
   @param {string} [options.target]
     The selector to replace.
-    Defaults to the `[up-target]`, `[up-modal]` or `[up-popup]` attribute on `link`.
+    Defaults to the link's `[up-target]`, `[up-modal]` or `[up-popup]` attribute.
     If no target is given, the `<body>` element will be replaced.
+  @param {String} [options.url]
+    The URL to navigate to.
+    Defaults to the link's `[up-href]` or `[href]` attribute.
   @param {boolean|string} [options.reveal=true]
     Whether to [reveal](/up.reveal) the target fragment after it was replaced.
@@ -145,8 +150,10 @@ up.link = (($) ->
   ###**
   This event is [emitted](/up.emit) when a link is [followed](/up.follow) through Unpoly.
+  The event is emitted on the `<a>` element that is being followed.
   @event up:link:follow
-  @param {jQuery} event.$element
+  @param {jQuery} event.$link
     The link element that will be followed.
   @param event.preventDefault()
     Event listeners may call this method to prevent the link from being followed.
@@ -162,7 +169,7 @@ up.link = (($) ->
     options = u.options(options)
-    url = u.option($link.attr('up-href'), $link.attr('href'))
+    url = u.option(options.url, $link.attr('up-href'), $link.attr('href'))
     target = u.option(options.target, $link.attr('up-target'))
     options.failTarget = u.option(options.failTarget, $link.attr('up-fail-target'))
     options.fallback = u.option(options.fallback, $link.attr('up-fallback'))
@@ -396,9 +403,9 @@ up.link = (($) ->
     or make an educated guess (default).
   @param {string} [up-layer='auto']
     The name of the layer that ought to be updated. Valid values are
-    `auto`, `page`, `modal` and `popup`.
+    `'auto'`, `'page'`, `'modal'` and `'popup'`.
-    If set to `auto` (default), Unpoly will try to find a match in the link's layer.
+    If set to `'auto'` (default), Unpoly will try to find a match in the link's layer.
     If no match was found in that layer,
     Unpoly will search in other layers, starting from the topmost layer.
   @param {string} [up-fail-layer='auto']

data/lib/assets/javascripts/unpoly/log.coffee CHANGED

@@ -18,7 +18,7 @@ up.log = (($) ->
   u = up.util
   b = up.browser
-  SESSION_KEY_ENABLED = 'up.log.enabled'
+  sessionStore = new up.store.Session('up.log')
   ###**
   Configures the logging output on the developer console.
@@ -41,7 +41,7 @@ up.log = (($) ->
   ###
   config = u.config
     prefix: '[UP] '
-    enabled: (b.sessionStorage().getItem(SESSION_KEY_ENABLED) == 'true')
+    enabled: sessionStore.get('enabled')
     collapse: false
   reset = ->
@@ -75,7 +75,7 @@ up.log = (($) ->
       b.puts('log', prefix(message), args...)
   ###**
-  @function up.log.warn
+  @function up.warn
   @internal
   ###
   warn = (message, args...) ->
@@ -126,8 +126,7 @@ up.log = (($) ->
   up.on 'up:framework:reset', reset
   setEnabled = (value) ->
-    # Session storage can only store string values
-    b.sessionStorage().setItem(SESSION_KEY_ENABLED, value.toString())
+    sessionStore.set('enabled', value)
     config.enabled = value
   ###**
@@ -165,3 +164,5 @@ up.log = (($) ->
 )(jQuery)
 up.puts = up.log.puts
+up.warn = up.log.warn

data/lib/assets/javascripts/unpoly/modal.coffee.erb CHANGED

@@ -439,7 +439,8 @@ up.modal = (($) ->
     $link = u.option(u.pluckKey(options, '$link'), u.nullJQuery())
     url = u.option(u.pluckKey(options, 'url'), $link.attr('up-href'), $link.attr('href'))
     html = u.option(u.pluckKey(options, 'html'))
-    target = u.option(u.pluckKey(options, 'target'), $link.attr('up-modal'), 'body')
+    target = u.option(u.pluckKey(options, 'target'), $link.attr('up-modal'))
+    validateTarget(target)
     options.flavor = u.option(options.flavor, $link.attr('up-flavor'), config.flavor)
     options.position = u.option(options.position, $link.attr('up-position'), flavorDefault('position', options.flavor))
     options.position = u.evalOption(options.position, $link: $link)
@@ -497,6 +498,12 @@ up.modal = (($) ->
           up.emit('up:modal:opened', message: 'Modal opened')
         promise
+  validateTarget = (target) ->
+    if u.isBlank(target)
+      up.fail('Cannot open a modal without a target selector')
+    else if target == 'body'
+      up.fail('Cannot open the <body> in a modal')
   ###**
   This event is [emitted](/up.emit) when a modal dialog is starting to open.
@@ -629,7 +636,7 @@ up.modal = (($) ->
     $element.closest('.up-modal').length > 0
   flavor = (name, overrideConfig = {}) ->
-    up.log.warn 'up.modal.flavor() is deprecated. Use the up.modal.flavors property instead.'
+    up.warn 'up.modal.flavor() is deprecated. Use the up.modal.flavors property instead.'
     u.assign(flavorOverrides(name), overrideConfig)
   ###**

data/lib/assets/javascripts/unpoly/motion.coffee.erb CHANGED

@@ -176,11 +176,7 @@ up.motion = (($) ->
   willAnimate = ($elements, animationOrTransition, options) ->
     options = animateOptions(options)
-    isEnabled() && !isNone(animationOrTransition) && options.duration > 0 && !isSingletonElement($elements)
-  isSingletonElement = ($element) ->
-    # jQuery's is() returns true if at least one element in the collection matches the selector
-    $element.is('body')
+    isEnabled() && !isNone(animationOrTransition) && options.duration > 0 && !u.isSingletonElement($elements)
   skipAnimate = ($element, animation) ->
     if u.isOptions(animation)
@@ -355,7 +351,7 @@ up.motion = (($) ->
       # Don't animate the scrolling. The { duration } option was meant for the transition.
       scrollOptions = u.merge(options, duration: 0)
       # Scroll $new into position before we start the enter animation.
-      up.layout.revealOrRestoreScroll($new, scrollOptions)
+      up.layout.scrollAfterInsertFragment($new, scrollOptions)
     if willMorph
       if motionTracker.isActive($old) && options.trackMotion is false

data/lib/assets/javascripts/unpoly/namespace.coffee.erb CHANGED

@@ -4,7 +4,7 @@
 window.up =
   version: <%= Unpoly::Rails::VERSION.to_json %>
-  renamedModule: (oldName, newName) ->
+  deprecateRenamedModule: (oldName, newName) ->
     Object.defineProperty? up, oldName, get: ->
-      up.log.warn("up.#{oldName} has been renamed to up.#{newName}")
+      up.warn("Deprecated: up.#{oldName} has been renamed to up.#{newName}")
       up[newName]

data/lib/assets/javascripts/unpoly/params.coffee.erb ADDED

@@ -0,0 +1,522 @@
+###**
+Request parameters
+==================
+Methods like [`up.replace()`](/up.replace) accept request parameters (or form data values) as a `{ params }` option.
+This module offers a consistent API to read and manipulate request parameters independent of their type.
+\#\#\# Supported parameter types
+The following types of parameters are supported:
+1. an object like `{ email: 'foo@bar.com' }`
+2. a [FormData](https://developer.mozilla.org/en-US/docs/Web/API/FormData) object
+3. a query string like `email=foo%40bar.com`
+4. an array of `{ name, value }` objects like `[{ name: 'email', value: 'foo@bar.com' }]`
+@class up.params
+###
+up.params = (($) ->
+  u = up.util
+  NATURE_MISSING = 0
+  NATURE_ARRAY = 1
+  NATURE_QUERY = 2
+  NATURE_FORM_DATA = 3
+  NATURE_OBJECT = 4
+  natureOf = (params) ->
+    if u.isMissing(params)
+      NATURE_MISSING
+    else if u.isArray(params)
+      NATURE_ARRAY
+    else if u.isString(params)
+      NATURE_QUERY
+    else if u.isFormData(params)
+      NATURE_FORM_DATA
+    else if u.isObject(params)
+      NATURE_OBJECT
+    else
+      up.fail("Unsupport params type: %o", params)
+  ###**
+  Returns an array representation of the given `params`.
+  The given params value may be of any [supported type](/up.params).
+  Each element in the returned array is an object with `{ name }` and `{ value }` properties.
+  \#\#\# Example
+      var array = up.params.toArray('foo=bar&baz=bam')
+      // array is now: [
+      //   { name: 'foo', value: 'bar' },
+      //   { name: 'baz', value: 'bam' },
+      // ]
+  @function up.params.toArray
+  @param {Object|FormData|string|Array|undefined} params
+    the params to convert
+  @return {Array}
+    an array representation of the given params
+  @experimental
+  ###
+  toArray = (params) ->
+    switch natureOf(params)
+      when NATURE_MISSING
+        []
+      when NATURE_ARRAY
+        params
+      when NATURE_QUERY
+        buildArrayFromQuery(params)
+      when NATURE_FORM_DATA
+        buildArrayFromFormData(params)
+      when NATURE_OBJECT
+        buildArrayFromObject(params)
+  ###**
+  Returns an object representation of the given `params`.
+  The given params value may be of any [supported type](/up.params).
+  The returned value is a simple JavaScript object whose properties correspond
+  to the key/values in the given `params`.
+  \#\#\# Example
+      var object = up.params.toObject('foo=bar&baz=bam')
+      // object is now: {
+      //   foo: 'bar',
+      //   baz: 'bam'
+      // ]
+  @function up.params.toObject
+  @param {Object|FormData|string|Array|undefined} params
+    the params to convert
+  @return {Array}
+    an object representation of the given params
+  @experimental
+  ###
+  toObject = (params) ->
+    switch natureOf(params)
+      when NATURE_MISSING
+        {}
+      when NATURE_ARRAY, NATURE_QUERY, NATURE_FORM_DATA
+        buildObjectFromArray(toArray(params))
+      when NATURE_OBJECT
+        params
+  ###**
+  Returns [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) representation of the given `params`.
+  The given params value may be of any [supported type](/up.params).
+  \#\#\# Example
+      var formData = up.params.toFormData('foo=bar&baz=bam')
+      formData.get('foo') // 'bar'
+      formData.get('baz') // 'bam'
+  @function up.params.toFormData
+  @param {Object|FormData|string|Array|undefined} params
+    the params to convert
+  @return {FormData}
+    a [`FormData`](https://developer.mozilla.org/en-US/docs/Web/API/FormData) representation of the given params
+  @experimental
+  ###
+  toFormData = (params) ->
+    switch natureOf(params)
+      when NATURE_MISSING
+        # Return an empty FormData object
+        new FormData()
+      when NATURE_ARRAY, NATURE_QUERY, NATURE_OBJECT
+        buildFormDataFromArray(toArray(params))
+      when NATURE_FORM_DATA
+        params
+  ###**
+  Returns an query string for the given `params`.
+  The given params value may be of any [supported type](/up.params).
+  The keys and values in the returned query string will be [percent-encoded](https://developer.mozilla.org/en-US/docs/Glossary/percent-encoding).
+  Non-primitive values (like [`File`](https://developer.mozilla.org/en-US/docs/Web/API/File) will be omitted from
+  the retuned query string.
+  \#\#\# Example
+      var query = up.params.toQuery({ foo: 'bar', baz: 'bam' })
+      // query is now: 'foo=bar&baz=bam'
+  @function up.params.toQuery
+  @param {Object|FormData|string|Array|undefined} params
+    the params to convert
+  @return {string}
+    a query string built from the given params
+  @experimental
+  ###
+  toQuery = (params) ->
+    switch natureOf(params)
+      when NATURE_MISSING
+        ''
+      when NATURE_QUERY
+        params
+      when NATURE_ARRAY, NATURE_FORM_DATA, NATURE_OBJECT
+        buildQueryFromArray(toArray(params))
+  arrayEntryToQuery = (entry) ->
+    value = entry.value
+    return undefined unless isPrimitiveValue(value)
+    query = encodeURIComponent(entry.name)
+    # There is a subtle difference when encoding blank values:
+    # 1. An undefined or null value is encoded to `key` with no equals sign
+    # 2. An empty string value is encoded to `key=` with an equals sign but no value
+    if u.isGiven(value)
+      query += "="
+      query += encodeURIComponent(value)
+    query
+  ###**
+  Returns whether the given value can be encoded into a query string.
+  We will have `File` values in our params when we serialize a form with a file input.
+  These entries will be filtered out when converting to a query string.
+  ###
+  isPrimitiveValue = (value) ->
+    u.isMissing(value) || u.isString(value) || u.isNumber(value) || u.isBoolean(value)
+  safeSet = (obj, k, value) ->
+    obj[k] = value  unless u.isBasicObjectProperty(k)
+  safeGet = (obj, k) ->
+    obj[k] unless u.isBasicObjectProperty(k)
+  buildQueryFromArray = (array) ->
+    parts = u.map(array, arrayEntryToQuery)
+    parts = u.compact(parts)
+    parts.join('&')
+  buildArrayFromQuery = (query) ->
+    array = []
+    for part in query.split('&')
+      if part
+        [name, value] = part.split('=')
+        name = decodeURIComponent(name)
+        # There are three forms we need to handle:
+        # (1) foo=bar should become { name: 'foo', bar: 'bar' }
+        # (2) foo=    should become { name: 'foo', bar: '' }
+        # (3) foo     should become { name: 'foo', bar: null }
+        if u.isGiven(value)
+          value = decodeURIComponent(value)
+        else
+          value = null
+        array.push({ name, value })
+    array
+  buildArrayFromObject = (object) ->
+    array = []
+    for k, v of object
+      array.push(name: k, value: v)
+    array
+  buildObjectFromArray = (array) ->
+    obj = {}
+    for entry in array
+      safeSet(obj, entry.name, entry.value)
+    obj
+  buildArrayFromFormData = (formData) ->
+    array = []
+    u.eachIterator formData.entries(), (value) ->
+      [name, value] = value
+      array.push({ name, value })
+    array
+  buildFormDataFromArray = (array) ->
+    formData = new FormData()
+    for entry in array
+      formData.append(entry.name, entry.value)
+    <% if ENV['JS_KNIFE'] %>formData.originalArray = array<% end %>
+    formData
+  buildURL = (base, params) ->
+    parts = [base, toQuery(params)]
+    parts = u.select(parts, u.isPresent)
+    separator = if u.contains(base, '?') then '&' else '?'
+    parts.join(separator)
+  ###**
+  Adds to the given `params` a new  entry with the given `name` and `value`.
+  The given params value may be of any [supported type](/up.params).
+  The given `params` value is changed in-place, if possible. Some types, such as query strings,
+  cannot be changed in-place. The return value is always a params value that includes the new entry.
+  \#\#\# Example
+      var obj = { foo: 'bar' }
+      up.params.add(obj, 'baz', 'bam')
+      // obj is now: { foo: 'bar', baz: 'bam' }
+  @function up.params.add
+  @param {string|object|FormData|Array|undefined} params
+  @param {string} name
+  @param {any} value
+  @return {string|object|FormData|Array}
+  @experimental
+  ###
+  add = (params, name, value) ->
+    newEntry = [{ name, value }]
+    assign(params, newEntry)
+  ###**
+  Returns a new params value that contains entries from both `params` and `otherParams`.
+  The given params value may be of any [supported type](/up.params).
+  This function creates a new params value. The given `params` argument is not changed.
+  @function up.params.merge
+  @param {string|object|FormData|Array|undefined} params
+  @param {string|object|FormData|Array|undefined} otherParams
+  @return {string|object|FormData|Array}
+  @experimental
+  ###
+  merge = (params, otherParams) ->
+    switch natureOf(params)
+      when NATURE_MISSING
+        merge({}, otherParams)
+      when NATURE_ARRAY
+        otherArray = toArray(otherParams)
+        params.concat(otherArray)
+      when NATURE_FORM_DATA
+        formData = new FormData()
+        assign(formData, params)
+        assign(formData, otherParams)
+        formData
+      when NATURE_QUERY
+        otherQuery = toQuery(otherParams)
+        parts = u.select([params, otherQuery], u.isPresent)
+        parts.join('&')
+      when NATURE_OBJECT
+        u.merge(params, toObject(otherParams))
+  ###**
+  Returns the first param value with the given `name` from the given `params`.
+  The given params value may be of any [supported type](/up.params).
+  \#\#\# Example
+      var array = [
+        { name: 'foo', value: 'bar' },
+        { name: 'baz', value: 'bam' }
+      }
+      value = up.params.get(array, 'baz')
+      // value is now: 'bam'
+  @function up.params.get
+  @experimental
+  ###
+  get = (params, name) ->
+    switch natureOf(params)
+      when NATURE_MISSING
+        undefined
+      when NATURE_ARRAY
+        entry = u.detect(params, (entry) -> entry.name == name)
+        entry?.value
+      when NATURE_FORM_DATA
+        value = params.get(name)
+        value = undefined if u.isNull(value)
+        value
+      when NATURE_QUERY
+        safeGet(toObject(params), name)
+      when NATURE_OBJECT
+        safeGet(params, name)
+  ###**
+  Extends the given `params` with entries from the given `otherParams`.
+  The given params value may be of any [supported type](/up.params).
+  The given `params` is changed in-place, if possible. Some types, such as query strings,
+  cannot be changed in-place. The return value is always a params value that includes the new entries.
+  @function up.params.assign
+  @param {string|object|FormData|Array|undefined} params
+  @param {string|object|FormData|Array|undefined} otherParams
+  @return {string|object|FormData|Array}
+  @experimental
+  ###
+  assign = (params, otherParams) ->
+    switch natureOf(params)
+      when NATURE_ARRAY
+        otherArray = toArray(otherParams)
+        params.push(otherArray...)
+        params
+      when NATURE_FORM_DATA
+        otherArray = toArray(otherParams)
+        for entry in otherArray
+          params.append(entry.name, entry.value)
+        params
+      when NATURE_OBJECT
+        u.assign(params, toObject(otherParams))
+      when NATURE_QUERY, NATURE_MISSING
+        # Strings and undefined are immutable, so we merge instead.
+        merge(params, otherParams)
+  submittingButton = (form) ->
+    $form = $(form)
+    submitButtonSelector = up.form.submitButtonSelector()
+    $activeElement = $(document.activeElement)
+    if $activeElement.is(submitButtonSelector) && $form.has($activeElement)
+      $activeElement[0]
+    else
+      # If no button is focused, we assume the first button in the form.
+      $form.find(submitButtonSelector)[0]
+  ###**
+  Serializes request params from the given `<form>`.
+  The returned params may be passed as `{ params }` option to
+  [`up.request()`](/up.request) or [`up.replace()`](/up.replace).
+  The serialized params will include the form's submit button, if that
+  button as a `name` attribute.
+  \#\#\#\# Example
+  Given this HTML form:
+      <form>
+        <input type="text" name="name" value="Foo Bar">
+        <input type="text" name="email" value="foo@bar.com">
+      </form>
+  This would serialize the form into an array representation:
+      var params = up.params.fromForm('input[name=email]')
+      // params is now: [
+      //   { name: 'name', value: 'Foo Bar' },
+      //   { name: 'email', value: 'foo@bar.com' }
+      // ]
+  @function up.params.fromForm
+  @param {Element|jQuery|string} form
+  @return {Array}
+  @experimental
+  ###
+  fromForm = (form) ->
+    if form = u.element(form)
+      fields = form.querySelectorAll(up.form.fieldSelector())
+      if button = submittingButton(form)
+        fields = u.toArray(fields)
+        fields.push(button)
+      return u.flatMap(fields, fromField)
+  ###**
+  Serializes request params from a single [input field](/up.form.config#config.fields).
+  To serialize an entire form, use [`up.params.fromForm()`](/up.params.fromForm).
+  Note that some fields may produce multiple params, such as `<select multiple>`.
+  \#\#\#\# Example
+  Given this HTML form:
+      <form>
+        <input type="text" name="email" value="foo@bar.com">
+        <input type="password" name="password">
+      </form>
+  This would retrieve request parameters from the `email` field:
+      var params = up.params.fromField('input[name=email]')
+      // params is now: [{ name: 'email', value: 'foo@bar.com' }]
+  @function up.params.fromField
+  @param {Element|jQuery|string} form
+  @return {Array}
+    an array of `{ name, value }` objects
+  @experimental
+  ###
+  fromField = (field) ->
+    params = []
+    if (field = u.element(field)) && (name = field.name) && (!field.disabled)
+      tagName = field.tagName
+      type = field.type
+      if tagName == 'SELECT'
+        for option in field.querySelectorAll('option')
+          if option.selected
+            params.push
+             name: name
+             value: option.value
+      else if type == 'checkbox' || type == 'radio'
+        if field.checked
+          params.push
+            name: name
+            value: field.value
+      else if type == 'file'
+        # The value of an input[type=file] is the local path displayed in the form.
+        # The actual File objects are in the #files property.
+        for file in field.files
+          params.push
+            name: name
+            value: file
+      else
+        params.push
+          name: name
+          value: field.value
+    params
+  ###**
+  Returns the [query string](https://en.wikipedia.org/wiki/Query_string) from the given URL.
+  The query string is returned **without** a leading question mark (`?`).
+  Returns `undefined` if the given URL has no query component.
+  You can access individual values from the returned query string using functions like
+  [`up.params.get()`](/up.params.get) or [`up.params.toObject()`](/up.params.toObject).
+  \#\#\# Example
+      var query = up.params.fromURL('http://foo.com?bar=baz')
+      // query is now: 'bar=baz'
+  @function up.params.fromURL
+  @param {string} url
+    The URL from which to extract the query string.
+  @return {string|undefined}
+    The given URL's query string, or `undefined` if the URL has no query component.
+  @experimental
+  ###
+  fromURL = (url) ->
+    urlParts = u.parseUrl(url)
+    if query = urlParts.search
+      query = query.replace(/^\?/, '')
+      query
+  toArray: toArray
+  toObject: toObject
+  toQuery: toQuery
+  toFormData: toFormData
+  buildURL: buildURL
+  get: get
+  add: add
+  assign: assign
+  merge: merge
+  fromForm: fromForm
+  fromURL: fromURL
+)(jQuery)