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

unpoly-rails 0.56.7 → 0.57.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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)