From 3f59ca67b49594ce234ba4b62b7418be8f8b8e03 Mon Sep 17 00:00:00 2001
From: Jeffrey Yasskin <jyasskin@google.com>
Date: Mon, 1 Aug 2016 17:52:48 -0700
Subject: [PATCH] feat(state): delegate to features for constraints

"Permission state" and "extra permission data" didn't explicitly say
that features could constrain them, or give features a clear place to do
it. This commit fixes that.
---
 index.bs | 26 ++++++++++++++++++++++----
 1 file changed, 22 insertions(+), 4 deletions(-)

diff --git a/index.bs b/index.bs
index 747dca8..23c20c8 100644
--- a/index.bs
+++ b/index.bs
@@ -221,7 +221,9 @@ spec: webidl
         </li>
         <li>
           Return whichever of the following options most accurately reflects the user's
-          intent for the calling algorithm:
+          intent for the calling algorithm, taking into account any
+          <a>permission state constraints</a> for
+          <code>|descriptor|.{{PermissionDescriptor/name}}</code>:
           <dl class="switch">
             <dt>succeed without prompting the user</dt>
             <dd>{{"granted"}}</dd>
@@ -270,7 +272,8 @@ spec: webidl
         </li>
         <li>
           Return the instance of |name|'s <a>extra permission data type</a> that
-          matches the UA's impression of the user's intent.
+          matches the UA's impression of the user's intent, taking into account
+          any <a>extra permission data constraints</a> for |name|.
         </li>
       </ol>
     </div>
@@ -702,14 +705,29 @@ spec: webidl
         grant access to midi-without-sysex.
       </p>
     </dd>
+
+    <dt>Optional <dfn export>permission state constraints</dfn></dt>
+    <dd>
+      Constraints on the values that the UA can return as a descriptor's
+      <a>permission state</a>. Defaults to no constraints beyond the user's
+      intent.
+    </dd>
+
     <dt>
       An optional <dfn export>extra permission data type</dfn>
     </dt>
     <dd>
       If specified, the <a>extra permission data</a> algorithm is usable for
-      this feature. The feature will specify any constraints on the values this
-      algorithm can return.
+      this feature.
     </dd>
+
+    <dt>Optional <dfn export>extra permission data constraints</dfn></dt>
+    <dd>
+      Constraints on the values that the UA can return as a {{PermissionName}}'s
+      <a>extra permission data</a>. Defaults to no constraints beyond the user's
+      intent.
+    </dd>
+
     <dt>
       A <dfn export>permission result type</dfn>
     </dt>