Feat: adds PaymentItemType enum + PaymentItem.type (#666)

Author: Marcos Cáceres

index.html

@@ -124,6 +124,11 @@ 
             <a href="https://github.com/w3c/payment-request/issues/617">issue
             617a>).
           li>
+          <li data-link-for="PaymentItem">
+            <a>PaymentItema>'s <a>typea> member and the
+            <a>PaymentItemTypea> enum (see <a href=
+            "https://github.com/w3c/payment-request/issues/163">issue 163a>).
+          li>
         ul>
       section>
     section>
@@ -281,6 +286,7 @@ 
               {
                 label: "Sales Tax",
                 amount: { currency: "USD", value: "5.00" },
+                type: "tax"
               },
             ],
             total: {
@@ -1851,6 +1857,8 @@ 
           required DOMString label;
           required PaymentCurrencyAmount amount;
           boolean pending = false;
+          // Note: type member is "at risk" of being removed!
+          PaymentItemType type;
         };
       pre>
       <p>
@@ -1884,7 +1892,63 @@ 
           the user interface for the payment request.
         dd>
       dl>
+      <div class="issue atrisk">
+        <p>
+          This feature has been marked "<a>at riska>". Firefox plans to
+          experiment with this feature during the Candidate Recommendation
+          phase. If you'd like for this feature to remain in the specification,
+          please signal your support for it to remain in <a href=
+          "https://github.com/w3c/payment-request/issues/163">issue 163a>.
+        p>
+        <dl>
+          <dt>
+            <dfn>typedfn> member
+          dt>
+          <dd data-tests="PaymentItem/type_member.https.html">
+            A <a>PaymentItemTypea> enum value, which a developer can use to
+            explicitly indicate that this member is of a particular type. A
+            user agent MAY use the value of <a>typea> to assist in the
+            presentation of <a>PaymentItema> by, for example, visually
+            grouping types together or other otherwise distinguishing them from
+            other types (or from items that have no associated type).
+          dd>
+          <dd>dd>
+        dl>
+      div>
     section>
+    <div class="issue atrisk">
+      <p>
+        This feature has been marked "<a>at riska>". Firefox plans to
+        experiment with this feature during the Candidate Recommendation phase.
+        If you'd like for this feature to remain in the specification, please
+        signal your support for it to remain in <a href=
+        "https://github.com/w3c/payment-request/issues/163">issue 163a>.
+      p>
+      <section data-dfn-for="PaymentItemType">
+        <h2>
+          <dfn>PaymentItemTypedfn> enum
+        h2>
+        <pre class="idl">
+          enum PaymentItemType {
+            "tax"
+          };
+        pre>
+        <p>
+          The <a>PaymentItemTypea> serves to categorize a <a>PaymentItema>
+          into particular types.
+        p>
+        <dl>
+          <dt>
+            "<dfn>taxdfn>"
+          dt>
+          <dd>
+            Indicates that the corresponding <a>PaymentItema> represents a form
+            of taxation. Examples include sales tax, goods and services tax,
+            value added tax, an so on.
+          dd>
+        dl>
+      section>
+    div>
     <section data-dfn-for="PaymentAddress" data-link-for="PaymentAddress">
       <h2>
         <dfn>PaymentAddressdfn> interface