v0.4.0 (#2)

Author: dillonredding

CHANGELOG.md

@@ -10,84 +10,95 @@ The format is based on [Keep a Changelog][kac], and this project adheres to
 
 ## Unreleased
 
+## 0.4.0
+
+### Changed
+
+- Submission of `application/x-www-form-urlencoded` and `text/plain` actions now
+  require [converting the entry list to name-value pairs][el2nvp] before running
+  the corresponding serializer. This realigns with the HTML standard and affects
+  newlines in fields' `name` and value.
+
+[el2nvp]: https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#convert-to-a-list-of-name-value-pairs
+
 ## 0.3.0 - 2021-06-17
 
 ### Added
 
-* Action submission specification
-* Action constraint validation specification
-* How to treat unrecognized field `type`s
-* Constraints for fields
-* How to apply the `pattern` property
-* Common `step` property for fields
-* Extensions for link objects: `hreflang` and `media`
-* `FileList` as an acceptable type for a `file` field's `files` property
+- Action submission specification
+- Action constraint validation specification
+- How to treat unrecognized field `type`s
+- Constraints for fields
+- How to apply the `pattern` property
+- Common `step` property for fields
+- Extensions for link objects: `hreflang` and `media`
+- `FileList` as an acceptable type for a `file` field's `files` property
 
 ### Changed
 
-* Clarified "type" as "data type" in recommendation of fields' `value`'s type
-* Several field extension and common property descriptions to align with
+- Clarified "type" as "data type" in recommendation of fields' `value`'s type
+- Several field extension and common property descriptions to align with
   constraint validation
-* Clarified adaptation of the HTML specification
+- Clarified adaptation of the HTML specification
 
 ### Fixed
 
-* Typo in "`checkbox` Fields" section
+- Typo in "`checkbox` Fields" section
 
 ### Removed
 
-* Column for specifying valid `value` formats; this is covered by constraint
+- Column for specifying valid `value` formats; this is covered by constraint
   validation
-* Mentions of HTML's checkedness concept
-* Unnecessary use of the term "element" in the Placeholder Label Option section
+- Mentions of HTML's checkedness concept
+- Unnecessary use of the term "element" in the Placeholder Label Option section
 
 ## 0.2.0 - 2021-01-04
 
 ### Added
 
-* Recommendation for field `value`'s types and format based on field's `type`
-* Defined how `null` or undefined field `value`s should be treated
-* Defined the `checked` property for `checkbox` fields
-* Defined a default value for `checkbox` fields' `value` property
-* Defined the `size` property for `select` fields
-* Defined semantics for placeholder label options in `select` fields
-* Defined the `accept` property for `files` fields
-* Defined semantics for `textarea` fields
-* Defined more common properties based on common HTML input attributes
-  * `dirname`
-  * `max`
-  * `maxlength`
-  * `min`
-  * `minlength`
-  * `placeholder`
-  * `readonly`
-* Added table summarizing when common properties apply to a field
+- Recommendation for field `value`'s types and format based on field's `type`
+- Defined how `null` or undefined field `value`s should be treated
+- Defined the `checked` property for `checkbox` fields
+- Defined a default value for `checkbox` fields' `value` property
+- Defined the `size` property for `select` fields
+- Defined semantics for placeholder label options in `select` fields
+- Defined the `accept` property for `files` fields
+- Defined semantics for `textarea` fields
+- Defined more common properties based on common HTML input attributes
+  - `dirname`
+  - `max`
+  - `maxlength`
+  - `min`
+  - `minlength`
+  - `placeholder`
+  - `readonly`
+- Added table summarizing when common properties apply to a field
 
 ### Changed
 
-* Moved mention of `files` property for consistency
-* Renamed the section "HTML Input Attributes" to "Common Properties"
-* Aligned type requirement for `multiple` `email` fields' `value` property with
+- Moved mention of `files` property for consistency
+- Renamed the section "HTML Input Attributes" to "Common Properties"
+- Aligned type requirement for `multiple` `email` fields' `value` property with
   the HTML specification ([#2])
-* Clarified when `disabled` and `required` properties apply to fields
-* Clarified what `disabled` means for the field's `value`
-* Clarified requirements for `required` fields
+- Clarified when `disabled` and `required` properties apply to fields
+- Clarified what `disabled` means for the field's `value`
+- Clarified requirements for `required` fields
 
 [#2]: https://github.com/dillonredding/siren-extensions/issues/2
 
 ### Removed
 
-* Removed mentions of the HTML version
+- Removed mentions of the HTML version
 
 ## 0.1.0 - 2020-12-04
 
 ### Added
 
-* Defined the `group` extension for `radio` fields
-* Defined semantics for `select` fields
-* Defined field properties corresponding to common HTML input attributes:
-  * `disabled`
-  * `files`
-  * `multiple`
-  * `pattern`
-  * `required`
+- Defined the `group` extension for `radio` fields
+- Defined semantics for `select` fields
+- Defined field properties corresponding to common HTML input attributes:
+  - `disabled`
+  - `files`
+  - `multiple`
+  - `pattern`
+  - `required`

README.md

@@ -185,9 +185,11 @@ steps:
 1. Otherwise:
    1. Switch on `action.type` (case-insensitive):
       - `"application/x-www-form-urlencoded"`, `null`, or undefined
+        1. Let `pairs` be the result of
+           [converting to a list of name-value pairs][el2nvp] with `entryList`.
         1. Let `body` be the result of running the
            [`application/x-www-form-urlencoded` serializer][axwfus] with
-           `entryList`.
+           `pairs`.
         1. Let `mimeType` be `"application/x-www-form-urlencoded"`.
       - `"multipart/form-data"`
         1. Let `body` be the result of running the
@@ -197,14 +199,17 @@ steps:
            `"boundary="`, and the `multipart/form-data` boundary string
            generated by the [`multipart/form-data` encoding algorithm][mfdea].
       - `"text/plain"`
+        1. Let `pairs` be the result of
+           [converting to a list of name-value pairs][el2nvp] with `entryList`.
         1. Let `body` be the result of running the
-           [`text/plain` encoding algorithm][tpea] with `entryList`.
+           [`text/plain` encoding algorithm][tpea] with `pairs`.
         1. Let `mimeType` be `"text/plain"`.
       - Otherwise, fail.
    1. Make an HTTP request where `url` is the request target, `method` is the
       request method, `mimeType` is the `Content-Type` header, and `body` is the
       message payload.
 
+[el2nvp]: https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#convert-to-a-list-of-name-value-pairs
 [rur]: https://html.spec.whatwg.org/multipage/urls-and-fetching.html#resulting-url-record
 [pau]: https://html.spec.whatwg.org/multipage/urls-and-fetching.html#parse-a-url
 [axwfus]: https://url.spec.whatwg.org/#concept-urlencoded-serializer